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ABSTRACT 


In today’s military interoperability is not a luxury, it is a _ necessity. 
Unfortunately, differences in data representation between various systems greatly 
complicate the task of achieving interoperability between them. Young’s Object- 
Oriented Method for Interoperability (OOMI) describes a modelbased, computer-aided 
methodology for resolving modeling differences among heterogeneous systems in order 
to enable system interoperability. The OOMI architecture and tool suite provide a high 
level of automation that will reduce the labor and complexity of integrating 
heterogeneous systems into a cooperative system of systems (federation of systems). The 
Component Model Correlation process in the OOMI architecture describes a 
methodology to correlate a component systems model of a real world entity to the 
federation model of the same real world entity. Once a correspondence is established, 
the OOMI tool suite facilitates the construction of wrapper-based translations between 
the component model and the federation model. These translations are then used in a 
run-time translator to enable interoperation between the federation of systems. This 
thesis describes the Component Model Correlation methodology and presents a prototype 
Component Model Correlator that assists an Interoperability Engineer in determining 


component model correspondence. 
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I. INTRODUCTION 


A. PURPOSE 


The purpose of this thesis is to develop and analyze a prototype implementation of 
the Component Model Correlation module of the Object-Oriented Method for 
Interoperability Integrated Development Environment (OOMI IDE) proposed by Young 


[You02]. This thesis consists of five chapters. 


Chapter I provides an introduction of the thesis and an overview of the Component 


Model Correlator. 


Chapter II provides background discussions on interoperability and its inhibitors, 
integration of systems and theoretical foundations of object correlation in order to form a 
federation ontology. A detailed review of the OOMI methodology and tool suite is also 


presented 


Chapter III discusses the component model correlation methodology within the 
OOMI IDE including semantic and syntactic component generation and semantic and 


syntactic correlation. 


Chapter IV presents an implementation of a prototype Component Model 
Correlator module for the OOMI IDE. The software module implements the methodology 


discussed in Chapter III. 


Chapter V provides conclusions and recommendation for future research. 


B. CORRELATOR OVERVIEW 


The Object-Oriented Method for Interoperability (OOMI) describes a model 
based, computer-aided methodology for resolving modeling differences among 
heterogeneous systems in order to enable system interoperability [You02]. It consists of 
three basic parts. The first component is the Federated Interoperability Object Model 
(FIOM). The FIOM is a model used to capture the real world entities whose state and 
behavior are shared between a federation of heterogeneous systems [You02]. The second 


component of the OOMI methodology is the OOMI IDE, which enables computer-aided, 
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pre-runtime construction of an FIOM. The last component is the run-time OOMI 
Translator. The OOMI Translator is a middleware component that uses software wrappers 
to resolve heterogeneities among systems, thus enabling interoperation [Lee02]. These 


three components of the OOMI are discussed in detail in II.D. 


Object correlation is the process of identifying correspondences among different 
system models of a real world entity. This is done by comparing a component model to 
the “standard” federation model of an entity. Once this correspondence is established, a 
translation can be defined resolving differences among systems. Correlation software 
assists the interoperability engineer in constructing and maintaining the FIOM by 
associating component system data models with the federated representation of reat world 
entities. In order to build a translation between a component system and the FIOM, we 
must first identify matching entities that can be translated. An English/Spanish bilingual 
dictionary can be used as an analogy for this process. The dictionary itself can be 
considered an FIOM. When a person wishes to translate the English word “son” into 
Spanish, they look up the word in the English portion and find the Spanish equivalent, in 
this case “hijo.” The act of looking up the translation and converting the English word 
into Spanish is similar to the function of the run-time OOMI Translator. But first, the 
dictionary editor must identify the associations between English and Spanish words, create 
the translations and then add the translations to the dictionary. The act of finding these 
associations describes the process of correlation; someone in the process must discover 


that the Spanish word “hijo” is equivalent to the English word “son.” 


In a federation of heterogeneous systems, finding associations between component 
system and federation models in order to build translations is far more complex. The 
OOMI IDE attempts to automate this process and the correlation software is a crucial 
module for automating the construction and maintenance of a FIOM. During construction 
of a new FIOM, an interoperability engineer can create Federation Class Representations 
(FCRs) that provide a federation model of a real world entity from schemas that define 
real world entities. When a new system is added to the federation, the interoperability 
engineer uses a Component Class Representation (CCR) that provides a component model 


of the real world entity to search the FIOM for a matching FCR. The search is performed 
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in two steps. First, a keyword search associates entities based on semantics, or meaning. 
Next, neural networks are used to filter keyword associations by syntax, or structure of an 
entity. The goal of correlation is to return a small set of FIOM FCRs that closely resemble 
the component system’s CCR. If there is a match, translations are constructed that 
translate between the component system model of an entity and the federated view of the 
entity. If there is no match, the interoperability engineer can add a new federated entity to 


the FIOM and complete the construction of the translations. 


In order to comprehend the search mechanisms of the correlator software, it is 
important to understand the structure of classes in object-oriented programming. Classes 
contain attributes and operations. [Each attribute and operation has descriptions and 
certain structural characteristics that can be used in the correlator software. For example, 
keywords can be captured from attribute names and description fields contained in the 
schema or interface definition. Syntactic or structural information can be derived from 


characteristics such as data type and frequency of occurrence. 


An important feature of the OOMI IDE and Correlator software is the use of XML 
schemas to represent a CCR and FCR. An XML schema can easily represent a component 
systems interface and facilitate computer automation. Further, an XML schema can be 
used to represent an object-oriented class construct in terms of the data contained in the 
class and the structure of the class itself. Complex data types can be decomposed into 
simple types and characteristics such as enumeration values can be defined. Thus, an 


object-oriented FIOM can be constructed that uses an object to model all entities. 
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Il. BACKGROUND 


A. INTEROPERABILITY AND ITS INHIBITORS 


In today’s military, interoperability is not a luxury...it is a necessity. According to 
the 2001 Quadrennial Defense Review: 


U.S. forces require the ability to communicate not only with one another, 
but also with other government agencies and allies and friends. Such joint 
and combined interoperability requires forces that can immediately "plug" 
into the joint battlefield operating systems (command and _ control, 
intelligence, fire support, logistics, etc.) and perform effectively. These 
forces need compatible systems with interoperable standards, doctrine, 
tactics, techniques, and procedures. [QDRO1] 


System interoperability involves not only the ability of systems to exchange 
information but also includes the capability for interaction and joint execution of tasks. 
[LISI98, Pit97]. Achieving this level of interoperability is difficult for two major reasons. 
First, legacy systems exist throughout the entire Department of Defense establishment that 
were designed without including provisions for interoperation. Like it or not, their 
existence is often necessary and in many cases it is prohibitively expensive to upgrade or 
retrofit legacy systems to make them capable of interoperation. The second difficulty in 
achieving interoperability is rooted in the fact that components were developed 
independently, with little or no requirement for interaction at a federation level. For 
example, components may have had requirements for intra-service interoperability but no 
requirement for inter-service interoperability. As a result, component systems that are 
being tied together may have different architectures, different hardware platforms, 
different operating systems, different host languages and different data models. These 
differences make the task of integrating systems time consuming and complex. 


1. Legacy Systems 


Throughout the Department of Defense, numerous legacy systems continue to 
perform various important functions, operating in a stand-alone configuration or within a 
closed system. As outline by [Pug01], there are many reasons why these nor- integrated, 


legacy systems exist: 


e The original intended system use was so restricted in scope that there was no 
need to integrate. Unfortunately, this paradigm was widespread in all the 
services and resulted in numerous “stove piped” systems. After all, why would 
an Air Force C4I system need to interoperate with a Navy C4I system? 


e The original system was classified at a security level above other systems, 
which precluded interconnection with systems at a lower security 
classification. 


e Personnel in the acquisition and development process, both contractors and 
government employees, failed to consider future integration for the system. 


e The original system designers never imagined that their system’s lifecycle 
would extend as long as it has. Subsequently, many unforeseen uses of the 
system and the benefits of connecting with new or previously unknown 
systems were not provided for in the original design. 


Not surprisingly, many of these legacy systems run on proprietary hardware and 
execute very old, proprietary software. The utopia of interoperability would be an 
environment where these different systems could communicate and share their 
information, a “system of systems.” Clearly, seamless integration of our independent 
systems would greatly increase our war fighting capability. 


2. Heterogeneity and Modeling Differences 


Young proposes a clear distinction between a federation of systems and an 
integrated system of components. The term “integrated system of components” is used to 
describe an interconnected compilation of homogenous components produced by a 
development team that shares common objectives and has a common view of the problem 
environment being modeled [You02]. In the personal computer domain, the Microsoft 
Office® software suite can be used as an example. Each application in the Office® suite 
is a homogeneous component but developed under the common “office” view. Thus 


integration is achieved. 


On the other hand, the term “federation of systems,” or “system federation,” 
describes an interconnected collection of independently developed heterogeneous systems 
or components [You02]. Most of the systems in the Department of Defense fall under this 
classification. Each service develops a number of heterogeneous systems and the entire 


goal of joint warfare is to interconnect these systems and overwhelm the enemy. 


Young [You02] describes eight types of heterogeneity that can be used to 


characterize potential differences in independently developed systems: 


Heterogeneity of Hardware and Operating Systems — Differences in the 
hardware and operating system platforms encountered when integrating 
autonomously developed systems can often lead to differences in the physical 
representation of information. For example, an integer may be represented in 
16 bits on system A but 32 bits on system B. Also, central processing units can 
implement arithmetic in different ways, which can lead to further differences in 


the representation of information. 


Heterogeneity of Organizational Models — Heterogeneity of organizational 


models refers to differences in the conceptual models used by autonomously 
developed systems. A common difference is the model used for analysis and 
design such as the use of Object-Oriented Analysis and Design (OOAD) versus 
Structured Analysis and Design (SAD). In the database domain, this type of 
heterogeneity can result from the use of relational, hierarchical or object 


structured databases. 


Heterogeneity of Structure — Structural heterogeneity refers to variations in the 
structure of how information is arranged among systems using the same 
organizational model, including differences in structural composition, possible 
schema mismatches, and variations due to the presence of implied information. 
For example, a ship can be modeled as a complex data type in one system and 
in another, the same entity is modeled as a string containing a contact track 


number. 


Heterogeneity of Presentation — Domain mismatch problems, the use of 
different units of measure, differences in precision, disparate data types, and 
different field lengths or variations in integrity constraints are types of 
heterogeneity of presentation. Two common examples of this type of 
heterogeneity are difference in position representation and differences in 


altitude representation. One system may use latitude and longitude for position 
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and height above the ellipsoid (HAE) for altitude while another uses the 
military grid reference system (MGRS) for position and mean sea level for 


altitude. 


Heterogeneity of Meaning — Heterogeneity of meaning refers to imprecise 
natural language characterizations of real world entities. Examples include 
homonyms, synonyms, and abbreviations. This type of heterogeneity is a 
chronic problem in the Department of Defense. One acronym can have 


multiple meanings depending on the domain in which it is used. 


Heterogeneity of Scope — Heterogeneity of scope describes the differences in 
the information used to model a real-world entity that arise from disjoint 
perspectives on the attributes a given application needs to capture about a real 
world entity. For example, the development team of a Marine Corps Targeting 
System may model an enemy tank with the attributes type, range and 
rateOfClosure. The developers of an Intelligence system may model the same 


enemy tank with the attributes classification, parentUnit, and fuelCapacity. 


Heterogeneity of Level of Abstraction — Heterogeneity of level of abstraction 
results from differences in the level and degree of aggregation of atomic data 
elements. For example, a training application used by a numbered fleet may 
model a battle group as a single unit. The fleet staff is focused on the training 
of the battle group in the aggregate. On the other hand, a similar training 
application used by a battle group staff models the battle group as a collection 


of distinct units. 


Heterogeneity of Temporal Validity— Heterogeneity of temporal validity refers 
to differences in the time used by two models to observe or record the state of a 
real world entity. A difference in the length of time data remains valid is 
another source of heterogeneity of temporal validity. For example, a Battle 
Group command and control system may require a second-by-second update 
on the positions of unit tracks while a Fleet level command and control system 


only needs a minute-by- minute or even hour-by-hour update. 
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3. Differences in View 


The eight classes of heterogeneity are further categorized by Young into 


differences in view and differences in representation. 


e Differences in view — Different systems can model different characteristics of a 
real world entity (heterogeneities of scope, level of abstraction and temporal 
validity [Wie93,Young02]). For example, in Figure II-1, three different views 
of a ground combat vehicle are shown. Each system modeling the ground 
combat vehicle does so in a manner that best fits the requirements of that 
system. In view 1, systems A and B capture information about the entity’s 
type, position, time and range. In contrast, system D views the ground combat 
vehicle in terms of type, position, time and status. Lastly, system C provides a 
third view by modeling the entity’s type, position, and time. Although the 
three views of the ground combat vehicle are similar, they are distinct in scope 


and level of abstraction and temporal validity. [Lee02] 


e Differences in representation — In addition, the same characteristics may be 
represented differently (heterogeneities of organizational models, structure and 
presentation [Wie93, Young02]). For instance, as shown in Figure I[I-1, 
system A represents the attributes position and time in latitude/longitude 
coordinates and Greenwich Mean Time (GMT) respectively. In contrast, 
system B represents position in military grid reference system (MGRS) 


coordinates and time in Local Mean Time (LMT). 
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Figure II-1. | Differing views of a real-world entity. [from You02] 


B. INTEGRATING SYSTEMS 


There are three basic ways to integrate heterogeneous systems to account for 
differing views: change one or both system’s hardware, change one or both system’s 
software, and through organizational change. [Pug01] Organizational change seems to be 
the predominant method although it is the least desirable. Organizational change is 
epitomized in the euphemism, “rather than develop a system we need, here is a system, 
now figure out where we need it.” The manifestations of organizational change are work- 
arounds and ad hoc methods to exchange useful, or even required information between 
systems. This results in a degradation of standards and increases the complexity of 
dealing with integration. For mission-critical systems, work-arounds and ad hoc methods 
are a very serious safety issue since they could potentially cause a system to behave in 


unintended and untested ways. 


Hardware changes are sometimes the only way to achieve system integration and 
this method can be relatively inexpensive. However, hardware cannot be used to resolve 
heterogeneities of modeling differences and does not contribute to the concept of 
interoperability. Software changes seem to be the best approach for achieving system 


integration and achieve interoperability. Software is inherently “lightweight” by its very 
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nature. However, poor software engineering practices and development methods can 


present challenges in using software for integration. 


The foundation of software integration lies in external interfaces. A system’s 
external interface is a contract of services between that system and the other systems or 
components that may need those services. External interfaces are almost always well 
defined and well documented and usually include the type of the provided data, accepted 
values, and formatting information. Interfaces encapsulate the implementation of features 
and allow a system to evolve. As long as the external interfaces do not change, the system 


is virtually free to change in any way, shape, or form. 


There are three approaches to system integration through software. In the first 
approach, integrators design and develop a system for integration and interoperability 
from the outset of the project. This requires knowledge of all the external interfaces for all 
the systems for which interoperability is required. The second approach is to reengineer 
legacy code to a newly identified external interface. The third approach is to create 
middleware in the form of software wrappers, which is essentially a translator between 
two external interfaces. There are many benefits to this approach that will be discussed 


shortly. 


In the first approach for integration with software, integrators design and develop a 
system for integration and interoperability from the outset of the project. When software 
is initially developed, the requirements should specify the level of interoperability 
required by the system under development. The requirements should also list the specific 
systems that the system under development will need to interoperate with. The system 
designers then obtain the external system interfaces of those systems and design the new 
system to conform to those external interfaces. As long as the developers of the new 
systems adhere to the external interfaces of the other systems, the new system should be 
able to integrate and interoperate smoothly. However, there are a few, rather large 
problems with this approach. First and foremost, whoever develops the requirements must 
know in advance all the systems that are likely candidates for interoperation or integration 
with the new system. As stated in the discussion of legacy systems, it is not possible to 


predict all the future uses of a system. Even with the star government-contractor team, not 
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all uses will be identified. When adding a new system that does not include provisions for 
interoperation with the existing system, reengineering will be required. This does not 
mean that interoperability should not be considered from the outset of a project. On the 
contrary, it is essential. However, the reality is that a new system will eventually be asked 
to perform in unintended ways, which leads to the last two approaches to software 


integration. 


Reengineering legacy code is problematic. In this method, programmers modify 
the source code of a system to meet the specifications of another external interface. There 
are many problems involved. To start, the source code for many COTS and legacy 
systems is simply not available. Secondly, the time and effort expended in 
comprehending and changing old code, often written in arcane programming languages 
like CSM-2, often greatly exceeds the time and effort that would be required to rewrite the 
code from scratch. Lastly, the resources needed for regression testing of the legacy code 
can be prohibitive. Despite these issues, there may be times when modifying legacy code 


is the only option. Fortunately, software wrappers usually provide a better alternative. 


Software wrappers are middleware that translate one external interface to another. 
These small pieces of software offer a lightweight solution to converting modeling 
differences between systems. In a simple case, software wrappers may only provide a 
mapping of data elements between two systems with no data conversions. In most cases, 
however, software wrappers provide data conversion routines to ensure data elements 
from systems conform to the external interface of another. In this fashion, wrappers are 
very useful. The major drawback in using software wrappers is the scalability for large- 
scale systems. Whenever a system is added to a domain of federated systems, a 
programmer has to develop a new wrapper for each system already attached. Figure II-2 
illustrates this point. Federation A and B consist of N component systems. Each 
components system requires a wrapper to the other systems, resulting in N(N-1) or N°-N 
wrappers. While Federation A has a total of 6 wrappers, Federation B needs 12 wrappers. 
This quadratic explosion of wrappers makes pair-wise wrapper construction for 


integration a poor choice. 
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Figure []-2. — Pair-wise software wrapper construction. [from Pug01] 


Alternatively, we can avoid combinatorial wrapper explosion by modeling the 
federation of systems in a star-like topology. In this case, every node that wants to 
communicate with another node first translates the communication to a common 
representation of the communication or real world entity. This common representation 
can be thought of as the “Jingua franca” [Pug0O1] for the federation and may be a single 
system’s representation of entities or may be a domain representation of entities. With 
this topology, each component system needs only two software wrappers, one to translate 
from its own system specific representation to the common representation, and one to 
translate from the common representation to the system specific representation. In 
comparison to the federation shown in Figure II-2, the number of software wrappers drops 
to 2N instead of N(N-1). Figure I-3 shows the benefits of using a common representation 


for software wrappers in a federation of systems. 
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Figure II-3. | Software wrappers for a common representation in a federation of systems. 
[from Pug01] 
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C. OBJECT CORRELATION IN A FEDERATED ONTOLOGY 


A federation of heterogeneous systems based upon a common representation or 
model, as shown in Figure II-3, is an ideal approach to integrate systems and promote 
interoperability. Information can then be exchanged using the common representation, 
with each system only concerned with the translation between the common model and its 
own internal model. New component systems can be added to the federation by creating a 
set of wrapper-based translations between the component system’s model of the 
information and the common model. As component systems evolve, translations can be 


modified, added or deleted. 


In order for systems in a federation to share information, system designers must 
resolve differences in what information is being shared, described as heterogeneity of 
scope, level of abstraction, or temporal validity, and differences in how information is 
represented, described as _ heterogeneity in structure, presentation, meaning, 
hardware/operating system, and organizational models. One method that can be used to 
model a common representation of information between federated systems is the use of an 
ontology. An ontology is “a knowledge base consisting of entities and relationships with 
abstraction, inference and typing mechanisms” [HL96, p.8]. As stated by Young: 


The federated ontology is a global schema to which 
attributes and operations in a component system are 
associated via syntactic and semantic information. These 
associations between the global schema and component 
system enable translations between the component and 
global schema model of an attribute or operation. [You02] 


The main benefit of using an ontology is its ability to resolve most types of 
heterogeneity. The primary drawback to this method is the time and effort needed to 
construct the required ontology. A federation of heterogeneous component systems brings 
together many models of real world entities that results in many views as discussed in 
Section II.A.3. Correlation between these disparate views of realworld entities is 
required whether the process occurs manually or through computer automation. The 
correlation is necessary in order to identify entities that can be translated to and from one 


another. Manual correlation between different models of each reat world entity can be 
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difficult, time-consuming and cost-prohibitive. The process of integrating databases 
involves the same correlation issues and offers a good example of the resources required 
for manual correlation. A group from GTE began a database integration process involving 
27,000 data elements from 40 applications. On average, the members of the group 
required 4 hours per element to extract, document and identify matching elements from 
the other applications. [LCO2] Given large, complex systems, the task of manually 
comparing data elements and attributes is unreasonably large. Clearly, in order to create 
and maintain a large-scale federation of systems based upon wrapper- based translations, a 


computer- automated correlator is required. 


D. OBJECT-ORIENTED METHOD FOR INTEROPERABILIY (OOMI) 


The Object-Oriented Method for Interoperability (OQOMI) [You02] describes a 
modeLbased, computer-aided methodology for resolving modeling differences among 
heterogeneous systems in order to enable system integration and achieve interoperability 
without the need to rework legacy code. The OOMI consists of three elements as 


illustrated in Figure II-4. 
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Figure II-4. | Components of the OOMI. [from You02] 


The first element is a general model of the interoperation between systems called a 
Federation Interoperability Object Model (FIOM). The second element is the OOMI 
Integrated Development Environment, a Computer Aided System Integration (CASI) tool 
that provides computer automation for the construction of an FIOM, data element and 


entity correlation, and construction of translations between the federated ontology and the 
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component systems. The last element is the OOMI Translator, which performs run-time 


translations between components systems. 


1. FIOM 


The Federation Interoperability Object Model (FIOM) forms a common ontology 
of Real World Entities (RWEs) that are shared among a federation of systems. The 
relationship of the FIOM to the other major components of the OOMI methodology is 


OOMI IDE OOMI Translator 


creates -maintains uses 


shown in Figure II-5. 








Figure II-5. Relationship of the FIOM with the major OOMI components. (after 
[Lee02]) 


The FIOM is composed of one or more Federation Entities (FEs), each providing 
an abstract representation of a real world entity (RWE). The FE comprises a hierarchical 
tree of one or more Federation Entity Views (FEVs) forming an inheritance hierarchy of 
FEVs within the FE. Each FEV represents the view that a component system or group of 


component systems has of the RWE. 
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Each FEV contains exactly one Federation Class Representation (FCR) that 
models the standard representation of the view. The FCR serves as the intermediate 
representation for translation between the source and destination systems. An FEV also 
contains one or more Component Class Representations (CCRs). The CCR is a direct 
mapping of a component system’s model of the RWE. Translations between the FCR and 
CCR are defined within the FIOM. Because an FEV contains exactly one FCR, 
translations are only need to be created between each component system and the FCR. 


Figure II-6 illustrates the components of an FEV. 





Component system 1 


<<translate>> 


Component system V 


Figure II]-6. |. FEV, FCR, CCR and Component Systems. [from Lee02] 


An FCR and CCR are modeled as an object-oriented class construct as depicted in 
Figure II-7. Each class contains the attributes and operations that represent the state and 
behavior of the RWE. The FCR describes the RWE from the federated point of view and 


the CCR describes the RWE from the component system point of view. 
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Figure II-7. 


An FE representation of the ground combat vehicle described in Section II.A.3 is depicted 
in Figure II-8. Each of the three views depicted by the systems becomes a separate FEV 
for the groundCombatVehicle FE. Notice, however, that each of the four component 
systems has a corresponding CCR with the FE hierarchy. System A and B, although 


represented by distinct CCRs, both view the groundCombatVehicle in the same manner as 


the gCV_View1_FCR. 


FE - groundCombatVehicle 





CCR_attribute1 


CCR _attribute2 


CCR_operation1 


<<translate>> ponCopeeiens 





CCR_attribute1 


CCR _attribute2 


<<translate>> 


CCR_operation1 
CCR_operation2 





FCR and CCR constructs. [after Lee02] 
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Figure II-8. 
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FE representation of the ground combat vehicle. 
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2 


OOMI IDE 


The OOMI Integrated Development Environment is a graphical user interface 


(GUI) based, Computer Aided System Integration (CASI) tool used by the Interoperability 


Engineer. 


3. 


The OOMI IDE provides computer automation in order to: 
Administer multiple FIOMs 


Specify different views of a real world entity resulting from the different 


perspectives each component system has of that entity 


Construct and maintain an inheritance hierarchy relating the different views of 


a real world entity 


Define standard federation representations of the real world entity views (FEV 
and its defining FCR) and the various component system representations 


(CCR) 


Integrate new components systems by finding correlations between component 


system representations and federation representations in the FIOM. 


Create the translations between a CCR and an FCR. 
OOMI Translator 


The OOMI Translator performs the run-time translations between component 


systems and the federated ontology. The FIOM, constructed for a specified federation of 


component systems during the pre-runtime phase, is used by the OOMI Translator at run- 


time to reconcile differences in reaktworld entity view and component system 


representation. The Translator receives source data or messages from a component system 


and retrieves the correct translation to convert the information to the federated 


representation. The translator than identifies the destination component system and 


retrieves the correct translation to convert the federated representation to the model 


recognizes by the destination system. See [Lee02] for an in depth discussion of the 


prototype OOMI Translator. 


4. 


FIOM Framework 
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The FIOM Framework developed by Lee [Lee02] is a set of Java interfaces and 
partially implemented Java classes used for the implementation of the OOMI IDE. This 
section provides a summary of the FIOM Framework with specific focus on the 
components that are relevant to correlation within the OOMI IDE. This background 
information is given in order to support the component model correlator methodology 
discussion of Chapter III and the implementation of the component model correlator 


presented in Chapter IV. 


The FIOM Framework, as defined in the package mil.navy.nps.cs.oomi.fiom, 
provides the functionalities required for implementing the OOMI IDE. The set of Java 
interfaces in this framework defines the objects modeling the FIOM. The set of Java 
classes defined in the mil.navy.nps.cs.oomi.impl package implement these interfaces. The 
OOM Database interface in the package mil.navy.nps.cs.oomi is used by the OOMI IDE 
to handle a collection of FIOMs. 
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Figure II-9. — mil.navy.nps.cs.oomi and mil.navy.nps.cs.oomi.fiom packages. [from 
Lee02] 


As stated, the interfaces in the mil-navy.nps.cs.oomi.fiom package are 


implemented in the mil.navy.nps.cs.comi.impl package. The naming convention for the 


21 


Java classes in this package is simply the name of the interface with “Impl” concatenated 
to the end. For example, the Java class implementing the FCR interface is named 
FCRImpl. Table Il-1 identifies the interfaces and corresponding implementations that are 
relevant to the correlation process discussed in this thesis. Modifications to the FIOM 
framework to support the implementation of the component model correlator are outlined 


in Section IV.A.2. 


Table I-1. Components of the FIOM Framework relevant to the OOMI IDE 
correlation process. 


FCR FCRImpl Provides the meta information of an FCR, 
composed of FCRSchema, FCRSemantics and 
Provides the meta information of a CCR, 
composed of CCRSchema, CCRSemantics and 
CCRSyntax interfaces 
Contains the complete information on_ the 
attributes of the FCR 


FCRSemantics | FCRSemanticsImpl | Contains the semantic components of the FCR that 
are used in the semantic search phase of the 
component model correlation process. See 
Section III.E 

FCRSyntax FCRSyntaxImpl Contains the syntactic components of the FCR that 
are used in the syntactic search phase of the 
component model correlation process. See 
Section IIL.F 


CCRSchema CCRSchemalmpl Contains the complete information on 
attributes of the CCR 


CCRSemantics | CCRSemanticsImpl | Contains the semantic components of the CCR 
that are used in the semantic search phase of the 
component model correlation process. See 
Section III.E 


CCRSyntax CCRSyntaxImpl Contains the syntactic components of the CCR 
that are used in the syntactic search phase of the 
component model correlation process. See 
Section III.F 
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Il. COMPONENT MODEL CORRELATION IN THE OOMI IDE 


A. THEORETICAL FOUNDATIONS OF CORRELATION 


As discussed in Section II.C, a federation of heterogeneous component systems 
can include many models of reatworld entities (RWE), which results in numerous, 
sometimes disparate views of the entity. A federated ontology can be used to model a 
common representation of the RWE in order to promote interoperability among the 
heterogeneous systems. Component model correlation is required to resolve modeling 
differences among systems in order to assist the interoperability engineer in building 
translations between the component system and the federation. This section is a summary 
of the detailed work by Young [You02] and Pugh [Pug01]. The basis for determining 
correlation effectiveness is discussed followed by the theoretical foundations of 
correlation and the applicability to interoperability. These topics are included as 
background information to support the discussion of the component model correlation 
methodology in the rest of Chapter II and the implementation of the component model 
correlator presented in Chapter IV. 


1. Correlation Effectiveness 


Salton and McGill [SM83] provide six evaluation criteria for determining the 
effectiveness of information retrieval systems: precision, recall, effort, time, presentation, 
and coverage. All six are important to the correlation of similar entities within the FIOM; 


however, precision and recall are the foremost measures of correlator effectiveness. 


[You02]. 


Precision is the ratio of relevant entities returned to the total number of entities 


returned. In a perfect system this number will be 1.0 signifying an exact match. 


Recall is the ratio of relevant entities returned to the actual number of relevant 
entities in the search space. High recall ensures that you have not set your threshold for 
correctness so high that possible matches are discarded. However, recall should be set 


high enough to avoid clutter and noise in the return values. 
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Effort is the amount of physical and intellectual work needed to perform the 


correlation. 


Time is the measure of how long (either in CPU epochs or real elapsed time) it 


takes to perform the correlation. 


Presentation is the method that the query uses to present data to the user. 
Different types of presentation may include a ranked list, where unlikely matches are 


included or a single “best match” candidate. 


Coverage is the measure of the search space the algorithm is able to correctly 
query. 

Zi Classical Approaches For Correlation 

Classical approaches to correlation include browsing, keyword matching and 
multtattribute searches. The major benefits of these approaches is the availability of 
information required for correlation, the relative simplicity of the various approaches, and 
the user’s ability to understand the use of the approach The disadvantage of the classical 
approaches is that they do not consider component behavior and subsequently do not 
achieve high values for precision and recall. Of the three approaches, keyword matching 
has the greatest applicability to component model correlation within OOMI [You02], 
[Pug01]. 


3. Formal Specification Approaches For Correlation 


Formal specification approaches for correlation include: 


e Syntax-based methodologies — Match components based on a composition and 
structure. Signature matching in software reuse is an examples a syntax based 


approach [You02]. 


e Semantics-based techniques — Attempt to use behavior to establish correlation 


between elements. 


e Combination of syntactic and semantic methods — A multi-level filtering 


approach to correlation. 
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The main problems with formal specification approaches are the difficulty of 
writing formal specifications and the time required to conduct semantic matching. Formal 
specification writing involves knowledge of a formal specification language and basic 
knowledge of discrete mathematics. Most developers are not familiar or comfortable with 
formal methods. Time problems with semantic matching are a result of the 
computationally intensive theorem proving approaches for semantic matching techniques. 
As stated by Young: 


The time and effort required to augment existing systems with formal 
specifications describing their behavior would outweigh any savings gained 
from the introduction of computer aid to the solution of the correlation 
problem. [You02] 


4. Artificial Intelligence Approaches For Correlation 
Artificial Intelligence approaches for correlation include: 


e Natural language techniques-— full-text information retrieval to extract syntactic 
and semantic information needed to establish correspondence between 


component models. 


e Neural networks techniques — attribute correspondence between components 
through the use of component meta-data and trained neural networks. The 
technique uses neural networks to learn the similarities among data from field 


specifications and data content. 


These two artificial intelligence approaches offer the greatest potential for 
application to component model correlation. In particular, the use of neural networks has 
been successful in database integration efforts, where data matching dosely relates to 
component model correlation. Specifically, a tool called SEMINT successfully uses 
neural networks to determine semantic correspondence of data elements based on 
metadata and data element instances. [LCO2] The process used by the SEMINT tool 


involves 5 steps: 


1. Metadata in the form of schema information and data content statistics 


is extracted from an individual database using DBMS specific parsers. 
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2. The metadata is normalized as a series of attribute vectors containing 
values of data content-based discriminators for each attribute. The 
attribute vectors are input to a self-organizing map algorithm that 
categorizes attributes into cluster centers according to their proximity to 


other attribute vectors on the map. 


3. The cluster centers are used to train a three-layer backward propagation 


neural network to recognize attribute categories. 


4. The trained neural network is provided the attribute information from 
another database from which it provides the similarity between each 
input attribute of this new database and each attribute category from the 


original database used to train the network. 


5. System users check and confirm the similarity results returned by the 


trained network. [LC0OO] 


The backpropagation neural network described in the SEMINT process is a 
powerful artificial intelligence tool used for complex logical operations, pattern 
association and optimization problems. A backpropagation neural network, illustrated in 


Figure [II-1, is a type of neural network that is trained to produce the same output given a 
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Figure III-1. Illustration of a backpropagation neural network. 
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66,99 66,99 


In other words, the network is trained to output “y” whenever it receives “x” as 
input. In order to train itself, the backpropagation neural network uses a supervised 
learning algorithm called the backpropagation learning algorithm. As shown in Figure 
II-1, a neural network consists of one or more layers of nodes that emulate the action of 
neurons in the human brain. In a multilayer neural network, a separate weight vector 
attaches a node to each successive node in the next layer. The backpropagation learning 
algorithm uses a computed network output error to change the weight values of the 
network in a backward direction. To get the network output error, a forwardpropagation 
phase must be done first. During forwardpropagation, the values of an input vector are 
passed into the nodes of the input layer of the neural network. If activated, the nodes then 
propagate the values to the next layer of nodes via the weighting vectors. For each node 
in the next layer, the input value is calculated as the sum of the weighted inputs. This 
process continues for every node layer in the neural network. At the completion of a 
single forwardpropagation pass, the nodes in the output layer provide an output vector of 
values, which are the results of the neural network. This output can then be compared to 


the output the network is trained to produce in order to perform pattern matching. 


While propagating in the forward direction, the nodes are activated using a 


sigmoid activation function. The formula of a binary sigmoid function is 


1 
l+e” 





fQ@)= [Eq 3.1] 


where y 8 the input value to the particular node. This is the most typical activation 
function and has the range [0,1]. [Fau94] Another common activation function is the 


bipolar sigmoid, which has a range of [-1,1] and is defined as 





f= 1 [Bq 3.2] 


It+e° 
where y is again the value of the input to the particular node. [Fau94] 


Training a neural network by backpropagation involves three stages: the 
forwardpropagation of an input training pattern, the backpropagation of the associated 


error between the desired output and actual output, and the adjustment of weights. Figure 


pz 


II- 1 shows the forwardpropagation as solid lines and the backpropagation as dashed lines. 
To begin training the net, the initial weights of weight matrix | and weight matrix 2 are 
randomized to values in the range [-0.5,0.5]. [Fau94] In the forwardpropagation, the input 
vector is passed into the input layer of neurons. Each neuron processes the input in 
accordance with the activation function and propagates the results to weight matrix1. 
Each output from the input layer is sent to each node of the hidden layer. In general, the 


number of hidden layer nodes should be 


Num + NUM py: 


output 


Eq.3.3 
; [Eq.3.3] 


NUM jy idden = 


Before the value arrives at the input of the hidden layer, it is multiplied by the value of the 
corresponding path of weight matrix 1. The actual input to the hidden layer is the sum of 
the weighted outputs from the input layer. The hidden layer nodes then use the activation 
function to process their inputs propagate the results to weight matrix 2. Like the hidden 
layer, the actual input to each output layer is the sum of the weighted outputs from the 
hidden layer. The output nodes then process the input using the activation function and 
produce an output vector. The output vector is compared to the desired output included in 


the training date and node errors are computed. 


Using the backpropagation technique, the errors calculated between the actual 
output and the desired output are propagated backwards through the network. Using the 
generalized delta rule [Fau94], each value in weight matrix 1 and weight matrix 2 are 
given an error information term and a weight correction term. When all the weight 
correction terms have been calculated the weights are updated and the next input vector is 
passed through the network. This process is repeated until the network produces results 
that are within the error tolerance set for the output error. An epoch is one cycle through 
the entire set of training vectors. Typically, many epochs, ranging from hundreds to 
thousands, are required for training a backpropagation neural network. This makes the use 


of these networks computationally expensive, but often times beneficial. [Fau94] 
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B. OOMI IDE COMPONENT MODEL CORRELATOR METHODOLOGY 


The OOMI IDE component model correlator is a module within the OOMI IDE 
that is responsible for establishing correspondences between component and federation 
models of a reatworld entity in the FIOM. Figure III-2 illustrates the position of the 
component model correlator module in relation to the other major components of the 
OOMI IDE. As presented in Section ILC, an FIOM describes a federated ontology for a 
federation of heterogeneous component systems. When a new component system is added 
to a federation, the interoperability engineer must add each source system Component 
Class Representations (CCR) to a matching FIOM Federated Entity (FE) described by one 
or more Federated Entity Views (FEV). In order to assist an interoperability engineer in 
this task, the component model correlator is used to search the FIOM for FEVs that match 
a source system’s CCR. If a match is found, then a translation can be constructed between 
a CCR and the FEV’s Federated Class Representation (FCR). Recall from Section 
IL.D.4that an FEV contains one and only one FCR, the FCR being the actual class 
construct used to represent the “standard” model of a real world entity. If no match exists, 
the interoperability engineer can either build a new Federation Entity (FE) and Federation 


Entity View (FEV) or add a new FEV to an existing FE. 
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Figure III-2. OOMI IDE Block diagram showing the relationship of the Component 
Model Correlator to the rest of the OOMI IDE. [after You02] 


The component model correlator methodology defined by Young [You02] and 
Pugh [Pug01] involves a two-phase filtering process using a mix of classical and artificial 
intelligence approaches. Correlation takes place during the Register Component Class 
Representation (CCR) phase of the overall FIOM construction process within the OOMI 
IDE. [You02] Phase one is a semantic search based upon the classical approach of 
keyword matching. The methodology for the semantic search process is discussed in 
Section III.E The implementation of a semantic correlator is presented in Section IV.C.2. 
Phase two uses neural networks to identify syntactic correspondence between CCRs and 
FCRs through the use of attribute pattern matching. The methodology for the syntactic 
search process is discussed in Section III.F. The implementation of a syntactic correlator 
is presented in Section IV.C.3. Each phase produces a correlation score whereby 
candidate FEVs can be ranked according to best match. The IDE also provides the 
capability to choose selected FEVs from the first phase of the correlation process for 
submission to the second phase. The desired effect is that the first phase will narrow the 
search scope for the computationally expensive neural networks used in the second phase. 
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A threshold value can be set for both phases of the correlation process to adjust the 
number of potential matches the interoperability engineer must examined. Although the 
OOMI IDE provides computer-aid for matching CCRs to the appropriate FE, the 
interoperability engineer must provide the ultimate determination of whether a CCR and 
FEV refer to the same real world entity. [You02] Figure IL-3 outlines the correlation 


methodology. 
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Figure III-3. UML Activity Diagram showing the component model correlation 
methodology within the OOMI IDE. 
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In order to utilize the component model correlator, semantic and syntactic search 
components must first be generated during the Add Component System External Interface 
phase of the overall FIOM construction process. [You02] As stated in the previous 
paragraph, the semantic search process uses keyword lists to find potential FEVs that 
match a CCR. A keyword list is generated from an FCR or CCR XML Schema file. The 
methodology for generating ©mantic components is discussed in Section II.C. The 
implementation of a semantic component generator is presented in Section IV.B.2. The 
syntactic search process attempts to conduct attribute pattern matching between a CCR 
and FCR through the use of backpropagation neural networks. In order to use this 
technique, vectors are needed that describe the structure of a CCR attribute or operation 


and an FCR attribute or operation. 
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Figure III-4. UML Activity Diagram showing the generation of semantic and syntactic 
components from within the OOMI IDE. 


When an FEV or CCR is added to the FIOM, discriminator vectors are created that 
describe the structure of each attribute and operation of the class representation. For an 
FEV, the discriminator vectors are then used to train a backpropagation neural network. 
Once trained, the neural network can be used to correlate a CCR to an FCR by attribute 
pattern matching. The methodology used for the generation of the syntactic search 
components is described in Section III.D. The implementation of a syntactic component 
generator is presented in Section IV.B.3. The pattern matching is performed by passing 


each discriminator vector of a CCR through the neural network of an FCR and computing 
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a pattern match score. Figure III-4 illustrates the process of generating semantic and 


syntactic components within the OOMI IDE. 


An important feature of the OOMI IDE and the correlation methodology is the use 
of well-formed XML Schemas to represent the information exported or imported through 
a component system’s external interfaces and to provide persistent storage for FCRs. The 
term “well-formed” means that the XML Schema is syntactically correct according to the 
W3C’s XML specification. [BM0O1] Thus, an ill-formed document will not be accepted 
for processing. This simplifies the internal code of parsers and also speeds up the 
processing of documents. An XML Schema is used to define the physical structure of an 
FCR or CCR through the use of specific tags to represent cardinality, relationships and 
data types. Complex data types can be broken down to simple types and characteristics 
such as enumeration values can be defined. Further, an XML Schema can include 
descriptor fields that provide comments about the overall schema, individual attributes or 


operations. Specific XML implementation considerations are discussed in Section IV.B.1. 


For purposes of discussion, the scenario presented in Figure H-1 of Section IL.A.3 
will be used throughout the following sections. In the diagram, four systems are shown, 
each providing a model for a reat world entity called a ground combat vehicle. System A 
and B have similar models of the real world entity and constitute view 1 of the ground 
combat vehicle. System C provides view 2 of the ground combat vehicle and System D 
provides view 3. Figure II-8 shows an FE representation of the ground combat vehicle as 
it would be modeled in the FIOM. 

. SEMANTIC COMPONENT GENERATION 


In order to perform the semantic search phase of component model correlation, the 
semantic search algorithm requires two list of keywords: 1) a keyword list describing the 
candidate Component Class Representation (CCR) and, 2) a keyword list describing the 
Federation Class Representation (FCR) of a real world entity. The semantic component 
generation process is illustrated in Figure III-5. Keyword information for a CCR is 
included in the XML Schema used to characterize a single component system’s external 
interface. For a federation representation (i.e. an FCR describing an FEV), keyword 


information can be obtained from an FCR XML Schema extracted from the FIOM, or can 
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be directly entered by the interoperability engineer. Table HI-1 defines a list of XML 
schema fields from which keyword descriptions can be obtained. Two additions are made 
to Pugh’s initial list: the ref attribute for an xsd:element component and the name attribute 
of an xsd:simpleType component. The ref attribute is similar in purpose to the type 
attribute, providing a description of the underlying data type names. The simpleType 
name attribute also gives the names of the underlying data types defined in the schema. 
The addition of these fields provides slightly more keyword detail than the original field 
list provided by Pugh. 


Table IlI-1. | XML Schema fields used for keyword generation. [after PugO1] 


xsd:element “name’ The name attribute typically equates to the 
field name used in the underlying database. 


xsd:element ‘type” For schemas using global types. This 
attribute’s value is usually descriptive of the 
kind of data in the subtype. (e.g. “data 
type”) 
xsd:element “ref? This attribute value is also descriptive of the 
ae kind of data in the subtype. (e.g. “data 
type”) 
xsd:documentation | N/A The text in this element is the “description” 
a field from the data dictionary. It is typically 
a human-readable free text explanation of 
the field’s use or format. 


xsd:attribute “name’ Gives amplifying information about a 
simple or complex type. 


xsd:enumeration ‘value’ Used to constrain the values of types. 
Usually used to limit a message field to 
several values, which will reveal the use of 
the message (e.g.. “SUB”, “SURF”, “ATR” 


Keyword information for a CCR is generated during the Add Component System 


xsd:simpleType “name” Gives the name of the underlying data 
types. Particularly beneficial if the data 
types declared in the element tags have the 
target namespace appended to the front of 
the name. 





External Interface phase of FIOM construction from the XML Schema defining the CCR. 
As proposed by Young, the keyword information is not extracted directly from the XML 
Schema document. [You02] Instead, keywords are extracted using the CCRSchema 


component created in the Add Component System External Interface process. Recall from 
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Section II.D.4 that the CCRSchema interface is a component of the FIOM Framework and 
contains the complete information on the attributes of the CCR. The keyword list created 


by the keyword generator is then stored with the CCR as a CCRSemantics component. 


Open FCR or CCR XML Schema File 


Parse XML Schema File 


Extract keyword information and add 
to FCR or CCRSemantics class 





Figure III-5. UML activity diagram of the component model correlator semantic 
component generation process. 


Keyword information for an FCR is generated in the Manage Federation Entities 
phase of the OOMI IDE either from an XML Schema defining the FCR, from information 
about a real world entity entered by the interoperability engineer, from keywords entered 
by the interoperability engineer, or from a combination of the three. As with the 
generation of CCR keyword information, the keyword information for an FCR is not 
extracted directly from an XML Schema document. [You02] Instead, keywords are 
extracted using the FCRSchema component created in the Manage Federation Entities 
phase. The keyword list created by the keyword generator is then stored with the FCR as 


an FCRSemantics component. 


This thesis proposes a modification to the methodology described above in order to 
simplify the extraction of keywords. Rather than extracting keywords from the 
FCRSchema or CCRSchema components, it is proposed that the keywords be extracted 


straight from an XML Schema. The reasoning for this change is to rely on the lightweight 
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standards and support for XML rather than create a complex process based on Java 


reflection for keyword generation. 


<?xml version="1.0" encoding="UTF-8"?> 
<xsd:schema targetNamespace="http://nps.navy.mil/cs/oomi/systemD' 
xmins:xsd="http://www.w3.org/2001/XMLSchema" xmins:systemD="http://nps.navy.mil/cs/oomi/systemD" 
elementFormDefault="qualified" attributeFormDefault="unqualified'> 
<xsd:element name ="armoredFightingVehicle'> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation> The armoredFightingVehicle of System D models the ground combat 
vehicle real-world entity.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="afvClassification" type="systemD:afvClassificationType"/> 
<xsd:element ref="systemD:afvLocation"/> 
<xsd:element ref="systemD:afvObsTime'/> 
<xsd:element name="afvStatus" type="systemD:afvStatusType" minOccurs="0"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="afvClassificationType "> 
<xsd:restriction base="xsd:string "> 
<xsd:minLength value ="5"/> 
<xsd:maxLength value="14"/> 
<xsd:enumeration value="battle Tank"/> 
<xsd:enumeration value="rocketLauncher"/> 
<xsd:enumeration value="truck’/> 
<xsd:enumeration value="unknown'/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:element name ="afvLocation"> 
<xsd:complexType > 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="latitude" type="systemD:latitudeType "/> 
<xsd:element name="longitude" type="systemD:longitudeType"/> 
</xsd:sequence> 
</xsd:complexType > 
</xsd:element> 
<xsd:element name ="afvObsTime"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation>The day of a month and timekeeping in hours and minutes of a calendar 
day, using the 24-hour clock system referenced to Greenwich Mean Time (GMT). </xsd:documentation > 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="day" type="systemD:dayType"/> 
<xsd:element name="hourTime" types"systemD:hourTimeType’/> 
<xsd:element name="minuteTime" type="systemD:minuteTimeType "/> 
<xsd:element name="stdTimeZone" type="systemD:stdTimeZoneType"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 


</xsd:schema> 


Figure III-6. Partial, well-formed XML Schema for the armored fighting vehicle. 


Young’s methodology relies on the use of Java-XML Data-Binding, a process in 
which an XML document is converted to its equivalent representation as a Java object and 
vice versa. During the Add Component System External Interface and Manage Federation 
Entities phases, XML schemas are unmarshalled, or converted to Java class objects. The 


FCRSchema and CCRSchema components, from which keyword information is supposed 
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to be generated, are then created. For persistent storage, when the user closes the OOMI 
IDE, the Java objects in the FIOM, including the FCR and FCRSchema components, are 
marshalled, or converted to XML Schema files. [Lee02] 


The proposed change to the methodology capitalizes on the lightweight nature of 
XML Schemas and the opensource Java packages available for XML processing. The 
start point of the Add Component System External Interface phase is a well-formed XML 
Schema. Figure I[I-6 shows a partial, well-formed XML schema for the armored fighting 
vehicle modeled by system D of the chapter example. Using the W3C Document Object 
Model (DOM) or the Apache Project JOOM package, keywords can be quickly generated 
straight from the XML Schema without the overhead required by Java-XML binding. A 
partial list of keywords generated for the armored fighting vehicle can be seen in Figure 


Ill-7 in the form of an XML document. 


<?xml version="1.0" encoding="UTF-8"?> 
<keywords>armoredFightingVehicle The armoredFightingVehicle of 
System D models the ground combat vehicle real-world entity 
aivClassification systemD:afvClassificationType systemD:afvLocation 
systemD:afvObsTime afvStatus systemD:afvStatusType 
atvClassificationType battleTank rocketLauncher truck unknown 
afvLocation latitude systemD:latitudeType longitude 
systemD:longitudeType afvObsTime The day of a month and timekeeping 
in hours and minutes of a calendar day, using the 24-hour clock system 
referenced to Greenwich Mean Time (GMT) day systemD:dayType 
hourTime systemD:hourTimeType minuteTime systemD:minuteTimeType 
stdTimeZone systemD:stdTimeZoneType 

</keywords> 


Figure III-7. Partial list of keywords generated with the semantic component generator. 


Picking up with the original methodology, the generated keyword list is stored 
with the CCR as a CCRSemantics component. Similarly, for the generation of an FCR 
keyword list, the FCR’s XML Schema can be parsed during the Manage Federation 
Entities phase. Another benefit of extracting keywords directly from an XML Schema is 
the decoupling of the keyword generator from the FIOM Framework. With an XML 
Schema as the only input, a keyword generator must simply analyze the XML Schema and 
return a list of keywords. The XML Schema elements listed in Table III-1 are 
standardized by the W3C and are logical choices for keyword extraction. By decoupling 


the keyword generator from the FIOM Framework, it becomes possible to use commercial 
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XML Schema keyword extractors should they become available. Additionally, changes to 
either the FIOM Framework or the implementation of a keyword generator will not 
adversely affect each other. 


D. SYNTACTIC COMPONENT GENERATION 


Syntactic components are used to support the neural network based syntactic 
matching process in the component model correlator [You02]. The syntactic components 
include two subcomponents. The first subcomponent is the discriminator vectors that 
describe the structure of the attributes of an entity defined by an FCR or CCR. The 
second subcomponent is a trained neural network belonging to an FCR. A description of 
these components as well as the methodology for their generation is discussed below. 


Figure III-8 illustrates the syntactic component generation process. 
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[More typeDefs] 


[No more typeDefs] 


Add list of discriminator vectors to 
CCRSyntax or FCRSyntax class 


Associate neural network to 
FCRSyntax component 









Figure III-8. UML activity diagram of the component model correlator syntactic 
component generation process. 
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1. Discriminator Vector Generation 


A backpropagation neural network is used to perform syntactic attribute pattern 
matching between a CCR and an FCR. Syntactic pattern matching refers to matching the 
syntax of attributes, or the way in which attributes are structurally represented. Some 
examples of syntactic information about an attribute include the attribute’s data type, 
whether or not the attribute is required, the maximum value if the attribute is a number, or 
the length if the attribute is a string. In order to use a backpropagation neural network, the 
neural network must first be trained by the backpropagation supervised learning 
algorithm. As discussed in Section III.A.4, the learning algorithm requires a set of input 
vectors with corresponding desired output vectors. When performing pattern matching 
with a trained neural network, the input to the network is a set of candidate input vectors. 
In the OOMI IDE component model correlator methodology, the vectors used for the 
neural networks are called discriminator vectors. A discriminator vector is an array of 
values in the range [0.0, 1.0] used to represent the data content and structure of each 


attribute and operation in a CCR or FCR. [You02] 


Discriminator Vectors for a CCR are created during the Add Component System 
External Interface phase of the OOMI IDE from an XML Schema of a single component 
system external interface. Discriminator vectors for an FCR are created during the 
Manage Federation Entities phase of the OOMI IDE. During the vector generation 
process, syntactic information is extracted from the XML Schema defining the CCR or 
FCR and a discriminator vector is constructed for each attribute and operation. A 
discriminator vector schema is defined in Table III-2. The discriminator vector schema 
proposed benefits from the metadata contained within an XML Schema. For example, the 
type specification of the discriminator vector is extracted from the base type definition 
component of an XML Schema simple type definition, which is a standardized XML 
Schema component from [BMO1]. Additionally, the minOccurs and maxOccurs elements 
of the discriminator vector are populated from the matching particle schema components 
of an XML element as defined in [TBM+01]. Lastly, the discriminator vector elements 


minLength, maxLength, totalDigits, fractionDigits, pattern, enumeration, maxInclusive, 


4] 


maxExclusive, minExclusive, and minInclusive are taken from the corresponding 


constraining facets of an XML data type, which are specified in [BMO1]. 


Table IfI-2. Metadata Based Discriminators Used in Syntactic Correlation Process. 


Number Discriminator Description 























21 


22 











24 


25 
27 
28 


Structural Information 





propertyType Operation or Attribute 

isComplex Describes whether an attribute is complex or atomic 

numSubtypes If attribute is complex, number of subtypes 

paper osat Ca a If attribute is ote a number of required subtypes 
tSubtypes S 





For operation — number of parameters ; 
For complex attribute — Sum of parameters for all operations 
defined for that attribute and any subtypes 





For Atomic Attributes — Specify the 
data type 

For Complex Attributes — sum of 
the number of subtypes of each 


double type 

bigDecimal type java.math.BigDecimal type 
int type primitive int type type 
long type primitive short type : 

short type primitive short type For Operations — sum of the number 
other type type other than listed above of parameters of each type 








minOccurs 





minimum number of times attribute must occur in class modeling 
real-world entit 


maxOccurs maximum number of times attribute may occur in class modeling 
real-world entit 


Data Size Specification 





minLength For Atomic String Type Attribute — minimum ae pe of string 
a Complex Attribute- Sum of minLengths of all string 
subtypes 

maxLength For Atomic String Type Attribute - maximum AG of string 
For Complex Attribute — Sum of maxLengths for all string 
subtypes 

totalDigits For Atomic bigDecimal Type Attribute — total number of digits 


included in attribute 
For Complex Attribute — Sum of total number of digits for all 
bigDecimal types 
fractionDigits For Atomic bigDecimal Type Attribute— number of digits in 
fraction part of attribute 
For Complex Attribute — Sum of total number of digits in 
fraction part for all bigDecimal types 
Data Value Constraints 
For Atomic Attribute — restriction to values allowed for string 
and numeric types 
For Complex ‘Attribute — number of attributes with pattern 
defined 
numEnumerations reais Attribute — number of enumeration values for 
attribute 
For Complex Attribute — sum of number of enumeration values 
for all subtypes 


pattern 












minExclusive lower open bound of interval defined for numeric attribute types 
upper open bound of interval defined for numeric attribute types 









lower closed bound of interval defined for numeric attribute 
types 
upper closed bound of interval defined for numeric attribute 


types 


minInclusive 





maxInclusive 


Each element of a CCR or FCR is first evaluated to determine if it is an attribute or 


an operation. For an operation, only the propertyType, numParameters, and type 
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specification discriminators are used. The discriminator propertyType simply identifies 
whether the vector describes an operation or an attribute. The discriminator 
numParameters represents the number of input parameters required by the operation’s 
signature. The type specification discriminators for an operation represent a tally of the 
number of each data type that is a parameter in the operation. For example, an operation 
that takes two String parameters would have the value “2” stored in the stringType 


discriminator element. 


If the element is an attribute, all discriminators, except for the discriminator 
numParameters, can be utilized. An attribute is further categorized as complex or atomic. 
An atomic attribute is one that cannot be decomposed into simpler types. The 
discriminator elements for an atomic attribute describe its basic structure. As shown in 
Table III-2, the discriminators for a complex element represent an aggregation of its 
atomic elements. To illustrate, suppose, a complex element is composed of two atomic 
elements of type String. The aggregation represented by the complex element 
discriminator vector would indicate the value “2” for the numSubTypes discriminator and 
the value “2” for the stringType discriminator. If the String subtypes had values for 
maxLength of 15 and 20 respectively, the aggregate value of maxLength for the complex 
element would be “35.” The technique of providing an aggregate discriminator vector for 
a complex element can be used throughout a type hierarchy. It is expected to provide 


adequate distinction between CCR and FCR attributes to enable pattern matching. 


The backpropagation neural networks in the OOMI IDE syntactic correlator use Eq 
3.1, the binary sigmoid function, for node activation. As stated in Section III.A.4, Eq 3.1 
is the most typical activation function and has the range [0.0,1.0]. As such, all values in 
the input vector are required to be in the range [0.0, 1.0]. In order to satisfy this 
requirement, an algorithm must be provided to normalize the raw values of the 
discriminator elements into the range [0.0, 1.0]. Table II-3 and Table II-4 define the 


normalized discriminator values used in the syntactic correlation process. 
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Number 


Table II-3. 


Discriminator 


propertyType 
isComplex 
numSubtypes 


numReqdSubtypes 


numOptSubtypes 


numOperations 


numParameters 


string type 
boolean type 
float type 
double type 
bigDecimal type 
int type 

long type 

short type 


other type 


minOccurs 


maxOccurs 


Discriminator Values Used for Syntactic Correlation. 


Value to Vector 


Structural Information 
Operation — 0.0 
Attribute — 1.0 
If yes — 1.0 
Otherwise — 0.0 
For operation or atomic attribute — 0.0 
For complex attribute - Value normalized to [0.0, 1.0] 
For operation or atomic attribute — 0.0 
For complex attribute - Value normalized to [0.0, 1.0] 
(subtype required unless minOccurs = 0) 
For operation or atomic attribute — 0.0 
For complex attribute - Value normalized to [0.0, 1.0] 
(subtype optional only if minOccurs = 0) 
For operation or atomic attribute — 0.0 
For complex attribute - Value normalized to [0.0, 1.0] 
For atomic attribute — 0.0 
For operation — value for # of parameters normalized to [0.0, 1.0] 
For complex attribute — value for sum of parameters for all operations 
in subtype normalized to [0.0, 1.0] “°°! 
Type Specifications 
If Atomic — < 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0 > 
If Complex — Value normalized to [0.0, 1.0] Note 
If Atomic — < 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] “’*! 
If Atomic — < 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] “°*! 
If Atomic — < 0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] oe 
If Atomic — < 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] N°*! 
If Atomic — < 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] “°*! 
If Atomic — < 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] “’*! 
If Atomic — < 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] Note} 
If Atomic — < 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 > 
If Complex — Value normalized to [0.0, 1.0] N°*! 
Frequency of Occurrence 
If Optional — 0.0 
Otherwise — 1.0 
If not specified — raw value = 1, normalized to [0.0, 1.0] 
Otherwise - value normalized to [0.0, 1.0] “°*! 


Note 1 


Note 1 


Note 1 


Note 1 


Note 1 


Note 1 


Note 1: Uses Eq 3.4: f(x) = 2 * (1/1 + k-x)-0.5) withk=1.01 
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Table I-4. Discriminator Values Used for Syntactic Correlation (Continued). 


Number | Discriminator Value to Vector 


pecification 

19 minLength If operation, attribute not string, or minLength not specified — 0.0; 
Otherwise - value normalized to [0.0, 1.0] “°°! 

20 maxLength If operation, attribute not string, or maxLength not specified — 0.0; 
Otherwise - value normalized to [0.0, 1.0] “°? 

21 totalDigits If operation, attribute not bigDecimal, or totalDigits not specified — 0.0; 
Otherwise - value normalized to [0.0, 1.0] N°? 

22 fractionDigits If operation, attribute not bigDecimal, or fractionDigits not specified — 

0.0; 

Otherwise - value normalized to [0.0, 1.0] N°’? 


Data Value Constraints 


23 pattern If Atomic — If pattern defined — 1.0 
Else 0.0 

For Complex Attribute — Value normalized to [0.0, 1.0] 

24 numEnumerations If operation or numEnumerations not specified — 0.0; 
Otherwise, value normalized to [0.0, 1.0] ‘°°! 

25 minExclusive If operation, attribute not numeric, or minExclusive not specified — 0.0; 
Otherwise - value normalized to [0.0, 1.0] N°? 

26 maxExclusive If operation, attribute not numeric, or maxExclusive not specified — 0.0; 
Otherwise - value normalized to [0.0, 1.0] “°*? 

27 minInclusive If operation, attribute not numeric, or minInclusive not specified — 0.0; 
Otherwise - value normalized to [0.0, 1.0] “°°? 

28 maxInclusive If operation, attribute not numeric, or maxInclusive not specified — 0.0; 
Otherwise - value normalized to [0.0, 1.0] N°? 


Note 1 





Note 1: Uses Eq 3.4: f(x) = 2 * (1/1 +k™*)—-0.5) with k= 1.01 
Note 2: Uses Eq 3.6: f(x) = log(x + 1)/5 


For some discriminators, such as minOccurs and pattern (for atomic attributes), the 
Boolean nature of the discriminator enables a direct mapping to a 0 or | value. Other 
parameters, such as numSubtypes, numReqdSubtypes, numOptSubtypes, numOperations, 
numParameters, maxOccurs, minLength, maxLength, totalDigits, fractionDigits, 
numEnumerations, minExclusive, maxExclusive, minInclusive, maxInclusive, and the type 
specifications (for complex attributes) must be normalized to a value in the range of [0.0, 
1.0]. For these values Li and Clifton used a SIGMOID- like function in order to avoid false 
matches or false drops that could occur when using a linear normalization function. For 
positive numeric values in the range of [0.0, 100.0] Li and Clifton used the function 


1 
9. | a ehh Eq 3.4 
Fixj=2 ae 0.5 [Eq 3.4] 
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where k is a constant equal to 1.01 and x is the parameter value to be normalized [LCOO]. 
For other numeric values that may be positive or negative [-50.0, 50.0], they used the 


function 





fQ@)= [Eq 3.5] 


1+k~* 


with k = 1.01. As each of the parameters numSubtypes, numRegdSubtypes, 
numOptSubtypes, numOperations, numParameters, maxOccurs, minLength, and 
numEnumerations are expected to have values in the range [0.0, 100.0], Eq 3.4 is used to 
normalize the values if these discriminators. The parameters maxLength, totalDigits, and 
fractionDigits may have values that exceed 100 for complex attributes. For example, a 
CCR attribute describing a data type for representing altitude, with a base type of integer 
or long, could have an extremely high value for maxLength. To account for this situation, 


a third function 


_ log(x +1) 


f(x) [Eq 3.6] 


has been defined which provides adequate discrimination between values in the range of 
[0, 100000]. Similarly, while parameters minExclusive, maxExclusive, minInclusive, and 
maxInclusive may have either positive or negative values, suggesting the use of Eq 3.2 for 
normalizing their values, the potential to exceed the bounds of [-50.0, 50.0] prescribed for 
use of that equation has led to the use of Eq 3.6 for normalizing these parameters as well. 
Figure III-9 provides a comparison graph showing the limits of each normalization 


equation with respect to the range [0.0,1.0]. 
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Comparison of Normilzation Equations 
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Figure III-9. Comparison of normalization equations. 





Lastly, as Table III-3 shows, the discriminator values for an atomic attribute’s data 
type require vectors of binary values instead of values within the range [0.0,1.0]. 
Establishing a categorical value in the range [0.0,1.0] for each data type would construe 
that a data type is “closer to” one type than another. For example if float were represented 
by 0.1, string by 0.2, and bigDecimal by 0.3, the neural network would conclude that a 
float is more like a string than a bigDecimal. Clearly, this does not have the desired 
effect. Instead, each data type has a sub vector with a unique value pattern. For example, 


string 1s represented by the vector 


< 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 >, 


boolean by 
< 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 > 


and so on. With this technique, each element of the type sub vector will stimulate its own 


neuron in the neural network and avoid any perceived “closeness” between data types. 
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As with the generation of the semantic components discussed in Section III.C, this 
thesis proposes a change to the methodology proposed by Young [You02]. In Young’s 
methodology for generating syntactic components, the discriminator generator uses the 
FCRSchema and CCRSchema components of the FIOM Framework as the source for 
syntactic information. [You02] Rather than extract syntax information from the 
FCRSchema or CCRSchema components, it is proposed that the syntactic information be 
extracted directly from an XML Schema. Figure III-10 shows the values for the 
discriminator vectors created from the armored fighting vehicle XML schema of Figure 
Ill-6. Again, the reasoning for this change is to rely on the lightweight standards and 
support for XML and decouple the discriminator generation from the FIOM Framework. 
As shown, most of the elements of a discriminator vector have a direct mapping to XML 
Schema components. This proposed change leaves intact the process of storing the 
generated discriminator vectors with a CCR as a CCRSyntax component or with an FCR 


as an FCRSyntax component. 
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ArmoredFightingVehicle 


Construction of Discriminator Vector 


fontaine eat [~[=[=[=[=]=[=[=[~[=]=[~] 


For complex attributes - sum of the number of suptypes or each type 


or atomic attributes - specify the type 
‘ is Num : 
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aad boolean] float double | Decimal int short | other 
Be hen a 


afvClassification 
afvLocation 
afvObsTime 


afvStatus 
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Construction of Discriminator Vector (Continued) 


min fraction 
Occurs Gu Digits 
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Attribute pattern 





Resulting Neural Net Input Discrimintator Vectors and Output Training Vectors 


afvClassification 1.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.50498 0.52487 0.23522 0.0 0.0 0.0 0.51990 0.0 0.0 0.0 0.0 


1.0 1.0 0.52984 0.50995 0.51990 0.5 0.5 0.51990 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 1.0 0.57449 0.57449 0.24082 0.0 0.0 0.5 0.51990 0.0 0.0 0.00.0 


afvObsTime 1.0 1.0 0.51990 0.5 0.5 0.5 0.5 0.51990 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.0 0.52487 0.53481 0.18062 0.0 0.0 0.51990 0.5 0.0 0.0 0.0 0.0 


afvStatus 1.0 0.0 0.5 0.5 0.5 0.5 0.5 1.0 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.0 0.51492 0.53481 0.21584 0.0 0.0 0.0 0.51492 0.0 0.0 0.0 0.0 





Figure III-10. Construction of the discriminator vectors for the armoredFighting Vehicle 
CCR. 


2. Neural Network Generation 


Every FCR in the FIOM must have a trained neural network as one of its syntactic 
components. As shown in Figure III-8, four major steps are involved in the generation of 
an FEV FCR neural network. The first step is to create the desired output vectors for the 
network. The second step is to create an instance of a backpropagation neural network. 
Next the newly created network is trained. Lastly, the trained neural network is saved to a 
file and the file name is stored with the FCR in the FCRSyntax component of the FIOM 


Framework. 


The first required step in generating the neural network is the creation of the 
desired output vectors needed to calculate the output error of the network during training. 


The output vectors are created with binary values in order to distinguish between each 
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attribute of the FCR. For example, an FCR with four attributes would have the following 
desired output vectors: 


attribute 1 < 1.0, 0.0, 0.0, 0.0 > 
attribute 2 < 0.0, 1.0, 0.0, 0.0 > 
attribute 2 < 0.0, 0.0, 1.0, 0.0 > 
attribute 2 < 0.0, 0.0, 0.0, 1.0 > 


The length of the desired output vectors equals the number of attributes represented by the 
FCR. The vector for each attribute contains a single value of 1.0 with the remaining 
values set to 0.0. The position of the value 1.0 creates a unique binary pattern for each 
attribute. The construction of the discriminator vectors and desired output vectors for the 
groundCombatVehicle_View3 FCR is shown in Figure III-11. Creating the output vectors 
with this technique facilitates pattern matching when CCR attributes are passed through an 


FCR neural network. 


In the second step, an instance of a backpropagation neural network is created. 
The component model correlator uses a three-layer backpropagation neural network. As 
discussed in Section IIL.A.4, this type of neural network has an input layer of nodes, a 
hidden layer of nodes, and an output layer of nodes. In order to create the neural network, 
the number of nodes in each layer must be specified. The number of input layer nodes is 
equal to the number of discriminator elements defined in Table III-2, which is equal to 28. 
The number of output layer nodes equals the number of attributes of the FEV FCR. This 
provides one distinct node for the representation of each FCR attribute and matches the 
desired output vector standard described above. The number of nodes in the hidden layer 
is 
numInput + numOutput 


numHidden = 5 


[Eq 3.7] 


which is the floor of the average of the input nodes and output nodes. The weight 
matrices of the neural network are automatically generated to fully connect the network 


graph between the input layer and the output layer. 
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GroundCombatVehicle_View3 
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Resulting Neural Net Input Discrimintator Vectors and Output Training Vectors 


Attribute Input Discriminator Vector Desired Output 


gCV3_VehicleType 1.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.50498 0.52487 0.23522 0.0 0.0 0.0 0.51990 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 


gCV3_Position 1.0 1.0 0.52984 0.50995 0.51990 0.5 0.5 0.51990 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 1.0 0.57449 0.57449 0.24082 0.0 0.0 0.5 0.51990 0.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 


gCV3_Time 1.0 1.0 0.51990 0.5 0.5 0.5 0.5 0.51990 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.0 0.52487 0.53481 0.18062 0.0 0.0 0.51990 0.5 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 


gCV3_StatusType 1.0.0.0 0.5 0.5 0.5 0.50.5 1.0 0.5 0.50.5 0.5 0.5 0.5 0.5 0.5 0.0 0.51492 0.53481 0.21584 0.0 0.0 0.0 0.51492 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 





Figure IIIJ-11. Construction of the discriminator vectors and desired output vectors for the 
GroundCombatVehicle_View3 FEV FCR. 


The neural network is trained in the third step with the backpropagation supervised 
learning algorithm discussed in Section III.A.4. The generated discriminator vectors and 
desired output vectors are used for the training process. In a single training instance, an 
FEV FCR attribute is forwardpropagated through the network and an error is computed 
between the actual output vector and the desired output vector. The weight matrices of the 
network are then adjusted. The next attribute is then passed through the network, the 
output error is calculated and the weights are again adjusted. This process continues until 
the neural network can produce the correct output, within a preset error tolerance, for 
every input vector of the training set. The preset error tolerance is set using the 
“preferences” option in the component model correlator window of the OOMI IDE. A 


typical value for the error tolerance is 0.1. Usually, neural network training can take 
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hundreds or even thousands of epochs, where an epoch is one cycle, or one pass of the 
attribute input vectors through the backpropagation learning algorithm. Once trained, 


66,99 


whenever the network sees the discriminator pattern for attribute “x” as the input, it will 


produce an output vector that resembles the predetermined output pattern “y” used in the 


training process. 


Two other preferences can be set to control the training process: the learning rate 
and maximum number of epochs. The learning rate is a value in the range [0.0,1.0] and 
used in the learning algorithm to compute the increment of adjustment to the values of the 
weight connectors between nodes. Recall from Section III.A.4 that the backpropagation 
learning algorithm computes the output error of the network and then backpropagates 
through the network to adjust the values of the weight connectors. The adjustments to the 
weight values are performed in calculated increments. The lower the learning rate value, 
the lower the increment. This results in a better-trained neural network, but the time 
required to train the network, given the small increments in weight adjustments, increases 
dramatically. The higher the learning rate, the larger the increment, which decreases the 
time required to train the neural network and increases the possibility of random errors. 
The maximum number of epochs is a simple maximum limit on the number of epochs the 
training process can go through. This serves to bound the amount of time taken to train 


the neural network. 


Once trained, the neural network is stored in a formatted file. The implementation 
in Section IV.D uses a special format for the neural network file as defined in the Java 
package mwa.ai.neural from [Wat97]. However, an XML document could also be used. 
The file name is then stored with the FCR in the FCRSyntax object. 

E. SEMANTIC CORRELATION 


The first phase of the component model correlator is the semantic, or keyword 
matching search. This phase of correlation attempts to narrow the search space for the 
second phase, the syntactic search discussed in Section III.F. In the semantic search 
process, a semantic correlator compares the keyword list of a candidate CCR to the 
keyword list of each FEV FCR contained in the FIOM. The keyword matching process 


computes a percentage of relevance with the function 
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number of correct matches 


oJ ___§_|_—§| [Eq 3.7] 
total number of CCR keywords 


% relevance = 
Before initiating the semantic correlator, two steps must be performed. First, the user can 
set the semantic correlation threshold to the desired value or accept the default value set 
by the OOMI IDE. The semantic correlator will then return FEV FCR matches with a 
percent relevance above the threshold setting. This is a valuable tool to limit the FEVs the 
interoperability engineer must analyze. In the second step, the user must select the CCR 


for which a match is desired. The selected CCR is then termed the candidate CCR. 


Once the threshold value is set and the candidate CCR is selected, the user starts 
the semantic correlator by selecting “Filter Using Keywords.” The semantic correlator 
first retrieves the keyword list for the candidate CCR, which is stored in the 
CCRSemantics component of the FIOM Framework. Then, the semantic correlator 
iterates through the FIOM and evaluates the keyword list for each FEV FCR in the FIOM. 
During the evaluation, the percent relevance for each FEV FCR is calculated using Eq 3.7 
and saved as the FEV keyword score. The process is then repeated for the next FEV FCR. 
After all the FEVs have been evaluated, the semantic correlator orders the results 
according to keyword match score and returns the ordered list of FEVs to the OOMI IDE. 
The OOMI IDE then displays FEVs whose keyword match score exceeds the threshold 
value. This enables the interoperability engineer to adjust the threshold value on the 
returned results and adjust the number of FEVs displayed. Figure I-12 illustrates the 


process. 


oo 







Get CCR to match 
Get Keyword threshold value 
For Each FEV In FIOM DO 
Obtain count of number of keywords in CCRSemantics component 
matched by keywords in FEV FCRSemantics component 
Normalize count as percentage of CCRSemantics 
keywords matched by FEV FCRSemantics keywords 
Store keyword match score and 
FEV Name in results table 








[More FEVs] 








[No more FEVs] 


Order results by keyword match score 
Display the FEV matches that are 
greater than the threshold setting 





Figure III-12. UML activity diagram of the component model correlator semantic search 
process. 


F. SYNTACTIC CORRELATION 


The second phase of the component model correlator is the syntactic search 


process performed by a syntactic correlator. The syntactic search process, which follows 
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the semantic search phase, attempts to find a one-to-one correlation between a candidate 
CCR and a specific FEV FCR through the use of trained neural networks and pattern 
matching. Before initiating the syntactic correlator the interoperability engineer must 
perform two steps. First, the threshold setting can be set or the user can accept the default 
value set by the OOMI IDE. The threshold setting for the syntactic correlator is used in 
the same fashion as the semantic correlator. The value limits the displayed results in order 
to decrease the number of FEVs that require final analysis by the interoperability engineer. 
Second, the interoperability engineer must select the specific FEVs that are to be passed 
into the syntactic correlator. This is done by manually selecting each FEV in the 
component model correlator window of the OOMI IDE or selecting the “Select All” 


option. 


After performing the two required steps listed above, the interoperability engineer 
initiates the syntactic correlator by selecting the “Filter Using Neural Net” option in the 
correlator window. The syntactic correlator first gets the syntactic components (the 
discriminator vectors) of the candidate CCR from the CCRSyntax component of the FIOM 
Framework. Next, the syntactic correlator iterates through the list of FEVs performing the 
syntactic evaluation for each FEV FCR. The evaluation is conducted using the FCR’s 
trained neural network retrieved from the FCRSyntax component of the FIOM 
Framework. The specific details of the evaluation process are discussed in the following 
paragraphs. A syntactic match score is obtained through each evaluation and is stored 
with the FEV in the results list. Once all the FEVs have been evaluated, the results list is 
ordered by syntactic score and returned to the OOMI IDE. The OOMI IDE then displays 
only those FEVs that score higher than the syntactic threshold setting. Like the semantic 
search process, this enables the interoperability engineer to adjust the threshold value on 
the returned results and adjust the number of FEVs displayed. Figure [I-13 illustrates the 


syntactic correlation phase of the component model correlator. 
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For Each FEV selected from the Keyword Filter DO 
For Each discriminator vector In CCRSyntax DO 
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Display the FEV matches that are greater 

than the neural network threshold 





Figure III-13. UML activity diagram of the component model correlator syntactic search 


process. 
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During the evaluation of the syntactic components, the discriminator vectors for a 
candidate CCR are passed through the trained backpropagation neural network of an FEV 
FCR. A notional example of this process is shown in Figure HI-14. In the example, a 


CCR discriminator vector with the values 
< 1.0, 0.0, 1.0, 0.321, 0.463 > 
is passed through the trained neural network. The output vector is calculated to be 
< 0.00642, 0.89123, 0.23451, 0.03123 >. 


As discussed in Section III.D.2, each output node of an FEV FCR neural network 
is used to represent a single FCR attribute. If an input vector correlates to an FCR 
attribute, the corresponding attribute node in the output layer will output a value close to 
1.0, while the remaining nodes will output a value close to 0.0. In this fashion, binary 
output vectors can be used to facilitate pattern matching. In the example given in Figure 
Il-14, the value from node 2 in the output layer is closer to 1.0 than the remaining output 
node values. This means that the CCR attribute being evaluated more closely correlates to 
attribute B of the FEV FCR than any other attribute. This does not necessarily mean that 
the attributes are an exact match with one another. Rather, the result indicates that the 
syntactic structure of the CCR attribute closely correlates to the syntactic structure of the 


FEV FCR attribute 8. 


ay 


CCR Schema Attribute Discriminator Input Layer Hidden Layer Output Layer Neural Net Output 





propertyType 


isComplex 


0.89123 


ot minOccurs 
discriminators 


maxOccurs 


minLength 





Node for FCR attribute a 


Node for FCR attribute 8 


Node for FCR attribute ? 


Node for FCR attribute d 


Figure III-14. Notional diagram of a backpropagation neural network showing a forward 
pass of a CCR schema attribute with the resulting output. [after You02] 


In order to establish a correlation score between an entire CCR and FEV FCR, a 


CCR-FCR correlation matrix is used. [You02] As each candidate CCR attribute is passed 


through the neural network of an FEV FCR, the output vector is recorded in a row of the 


comparison matrix. Figure If-15 shows the completed comparison matrix for the 


armoredFighting Vehicle CCR and groundCombatVehicle_View3 FCR comparison. 


FCR Schema 
Attributes 
Type Position Time Status 
afvClassification 0.8319 0.0013 0.0002 0.1464 
CCR Schema _ afvLocation 0.0056 0.9875 0.0013 6.2e-6 
Attributes afvObsTime 1.6e-7 0.0029 0.9911 0.0374 
afvStatus 0.0849 0.0003 0.0008 0.9201 


Row 
Maximun 


(X) (X°) 


0.8319 0.6921 
0.9875 0.9752 
0.9911 0.9823 
0.9201 0.8464 


VE) 4.8698 


(As Percent of Maximum 2-Norm) 93.49 


Figure II-15. Computing single value for CCR-FCR Comparison Matrix. [after You02] 
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Once the CCR-FCR comparison matrix is complete, an overall comparison score is 
obtained by computing the 2-norm of the maximum value from each row. The 2-norm or 
length of a vector is computed by taking the square root of the sum of the squares of each 
element in the vector [Ant94]. The ratio of the computed 2-norm of the row maximums to 
a perfect CCR-FCR match is the final value saved for the FCR comparison. Since the 
FCR neural networks are trained using binary desired output vectors, the maximum 
possible value for any row is 1.0. Hence, the theoretical 2-norm for a perfect match is 


simply 


,{num FCR attributes [Eq 3.8] 


which becomes the divisor in the ratio calculation. The 2-norm provides a higher score to 
an FCR, which provides a perfect or near-perfect match for one or more CCR attributes 
than to an FCR that doesn’t provide a close match with any of the CCR attributes. As 
Figure I-15 shows, the groundCombatVehicle_View3 FCR has four attributes, giving a 
perfect 2-norm of 2.0. The calculated 2-norm of the comparison with the 
armoredFightingVehicle CCR is 1.86, resulting in 93.5% score. This value can be 
interpreted to mean that the groundCombatVehicle_View3 FCR is 93.5% syntactically 
relevant to the armoredFighting Vehicle CCR. 


A high syntactic correlation score does not guarantee a one-to-one correspondence 
between a candidate CCR and an FEV FCR. Using the 2norm method alone, there are 
two cases for potential false-positive results. First, there may be cases when multiple 
attributes or operations of a CCR resemble a single attribute or operation of an FCR. This 
would result in a false-positive CCR-FCR Comparison Matrix as shown in Figure III-16. 
In this case, the percentage score obtained by the comparison is identical to the score 
computed in Figure If]-15. However, the CCR attributes afvLocation and afvObsTime 
both correlate to the FCR attribute Time. Similarly, the CCR attributes afvClassification 
and afvStatus both correlate to the FCR attribute Type. CCR-FCR correspondence 
requires a one-to-one correspondence between the attribute and operation sets. Hence, this 
scenario does not result in correspondence between the CCR and FCR and is considered a 


false positive. In the second case, the number of attributes of a CCR may not match the 
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number of attributes of an FCR. If the number of CCR attributes is less than the number 
of FCR attributes, the CCR-FCR comparison matrix should contain missing column 
values since one-to-one correspondence is impossible. Similarly, if the number of CCR 
attributes is greater than the number of FCR attributes, the CCR-FCR comparison matrix 
should contain duplicate column matches. However, in both situations, the 2-norm score 


may still be high and produce a false-positive result. 





FCR Schema 

Attributes Row 

Maximun 
Type Position Time Status (X) (X?) 
afvClassification 0.0013 0.0002 0.1464 0.8319 0.6921 
CCR Schema _afvLocation 0.0056 0.0013 6.2e-6 0.9875 0.9752 
Attributes afvObsTime 1.6e7 0.0029 0.9911) 0.0374 0.9911 0.9823 
afvStatus 0.0003 0.0008 0.0849 0.9201 0.8464 
JZ02) ~—s-1.8698 


(As Percent of Maximum 2-Norm) 93.49 


Figure III-16. Example of a false-positive syntactic correlation. 


A method to avoid false positives in the syntactic correlation process involves two 
steps. First, the number of attributes of a CCR is compared to the number of attributes of 
an FCR. Only FCRs with an equal number of attributes are syntactically evaluated. 
Second, a record of unique attribute matches is maintained during the evaluation of an 
FCR. In this step, an output vector produced from an FCR’s neural network is checked to 
identify which attribute it most closely correlates with. The check is performed by 
determining the attribute position of each row maximum in the comparison matrix. A 
record can then be maintained to indicate whether or not an FCR attribute has received a 
potential match or not. Once the comparison matrix is complete, the number of matches 
can then be used as a true or false filter for the FCRs with a comparison matrix score 
above the threshold setting. For example, consider the comparison matrix in Figure 
I-15. As the matrix is constructed, a record indicates that all 4 FCR attributes have been 
potentially matched. The record may be in the form of a boolean array sized to match the 


number of FCR attributes. A true value in the array indicates that the corresponding 
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attribute or operation has been matched at least once. A false indicates that the 
comparison matrix includes no matches for that attribute or operation. Since the number 
of matches for a one-to-one correspondence must exactly equal the number of attributes or 
operations defined in the FCR, one or more false values in the results record eliminates the 
FCR as a potential match to the CCR despite a high 2-norm score. Using this method, the 
comparison matrix shown in Figure IIJ-16 produces a count of 2 attribute matches in the 
results array instead of 4. Thus, the potential false positive is eliminated from 


consideration. 


The method described above is valid since CCR-FCR correspondence requires a 
one-to-one correspondence between the attribute and operation sets. If an FCR has n 
attributes or operations, then one-to-one correspondence requires n matching attributes or 
operations in the CCR. Therefore, any match count less than the number of FCR 
attributes does not have one-to-one correspondence. In other words, any FCR attribute or 
operation with a match record set to 0 or false, would fail the comparison matrix. 
However, since there are cases when the interoperability engineer may want to analyze all 
results, the one-to-one correspondence option can be turned off as an option in the OOMI 


IDE. 


In order to use this method to eliminate false-positive results, an attribute threshold 
value must be used to determine whether or not a row maximum is high enough to infer 
correlation between a CCR input vector and the FCR attribute. Since the FCR neural 
network uses binary desired output vectors, a CCR attribute or operation correlates to an 
FCR attribute or operation when one of its values is close to 1.0 and the remaining values 
are close to 0.0. However, the values can be in the range [0.0,1.0] as illustrated in Figure 
I-15. The row maximums that indicate correspondence are close to the upper bound of 
the potential range, but a distinct threshold value is needed in order to conclude that the 
row maximum indicates a potential match. The threshold can be the same value as the 
neural network threshold setting in the correlator panel, or it can be an entirely different 


threshold setting. The interoperability engineer must determine the exact value. 
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G. SUMMARY 


The OOMI IDE component model correlator methodology is used to assist the 
interoperability engineer in adding a Component Class Representation (CCR) to a 
Federation Interoperability Object Model (FIOM) during the Register Component Class 
Representation phase of the overall FIOM construction process within the OOMI IDE. 
The goal of component model correlation & to assist the interoperability engineer in the 
construction of translations between component systems and the federated ontology by 


identifying potential matches in data models between a component system and the FIOM. 


The component model correlator uses a two-phase approach to establish 
correspondence between component models and federation models. In phase one, a 
semantic, or keyword matching process takes place using keyword information extracted 
from specific elements of a CCR and FCR. In the second phase, details about the 
structure and composition of the attributes and operations used to model the real world 
entity are used in conjunction with neural networks to provide syntactic correlation. Each 
phase of the correlation provides a score to the interoperability engineer. Based on the 
scores of the semantic search, the interoperability engineer can select a set of potential 
FEV matches to be passed to the second phase. Comparisons of the overall scores among 
potential FCR matches guide the interoperability engineer toward the most likely match 
for a CCR. However, final determination of CCR-FCR correspondence requires a one-to- 
one correspondence between the attribute and operation sets of a potential CCR-FCR 
match. This final determination of equivalence is the responsibility of the interoperability 


engineer and is not automated in the OOMI IDE. 
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IV. COMPONENT MODEL CORRELATOR IMPLEMENTATION 


A. COMPONENT MODEL CORRELATOR MODULE 


As discussed in Section III.B, the Component Model Correlator is a module within 
the OOMI IDE that is responsible for establishing correspondences between component 
and federation models of a real world entity in the FIOM. Figure III-2 illustrates the 
position of the component model correlator module in relation to the other major 
components of the OOMI IDE. The Component Model Correlator module implements the 
methodology described in Chapter HI. It generates the semantic components required for 
the semantic correlation phase and generates the necessary syntactic components for the 
syntactic correlation phase. Additionally, the module performs both semantic and 


syntactic correlation of a component system CCR to an FEV in the FIOM. 


OOMI IDE Component Model Correlator 


Generate Semantic 
Components 
ae Generate Syntactic 
Components 

FIOM Database 


Interoperability Perform Semantic 

Engineer Tt Correlation 
Perform Syntactic 
Correlation 


Figure [V-1. UML Use Case diagram for Component Model Correlator. 








The use case diagram developed for the implementation of the Component Model 
Correlator is shown in Figure IV-1. The two primary actors involved in these use cases 
are the interoperability engineer and the FIOM Database. The interoperability engineer 
interacts with the Component Model Correlator through the user interface of the OOMI 
IDE. Each of the four use cases identified interacts with FIOM Database, which is the 
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repository for the FIOM components. The use cases above directly correspond to the 


aspects of the correlator methodology discussed in Chapter III. 


The abstract architecture shown in Figure [V-2 converts the Component Model 
Correlator use cases into modular subcomponents. The ComponentModelCorrelator 
subcomponent is the executive of the entire module. It receives commands from the 
OOMI IDE then initiates the appropriate action with either a Generators subcomponent or 
a Correlators subcomponent. The Generators subcomponent is an abstraction of both a 
Semantic and Syntactic Component Generator. The Semantic and Syntactic Component 
Generators implement the semantic and syntactic component generation methodology 
discussed in Section III.C and Section III.D respectively. Similarly, the Correlators 
subcomponent is an abstraction of both a Semantic and Syntactic Correlator. The 
Semantic and Syntactic Correlators implement the semantic and syntactic correlation 


methodology outlined in Section III.Eand Section III-F respectively. 
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Figure [V-2. Abstract Component Model Correlator architecture. 
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After receiving a command from the ComponentModelCorrelator executive, the 
Generators or Correlators subcomponent completes the required action and passes data 
back to the ComponentModelCorrelator. The ComponentModelCorrelator then performs 
any data formatting or data conversion required prior to sending that output data back to 
the OOMI IDE. This architecture adheres to standard software engineering principles, 
particularly abstraction, modularity and the principles of cohesion and coupling. The 
architecture is both scalable and extendable. This is very important since the 
methodologies for the Generators and Correlators subcomponents will undoubtedly be 


revised or completely changed over time. 


This thesis implements a prototype of the architecture presented in Figure IV-2. 
The prototype Component Model Correlator module is coded in Java using Sun’s JDK 
1.3.1_04. The classes and packages of the module are shown in Figure I[V-3 along with 
important associations with other packages of the OOMI IDE prototype. As shown, the 
modular architecture converts easily into the Java package framework. The Generators 
and Correlators architectural subcomponents map to respective semantic and syntactic 
generator packages and semantic and syntactic correlation packages in the Java 
implementation. However, the ComponentModelCorrelator subcomponent is not a 
separate package. Rather, the component & realized in the ComponentModelCorrelator 
class directly under the Correlator Java package. The Java implementation shown in 
Figure [V-3 makes use of Java interfaces at all levels. The interfaces define a contract of 
services between the ComponentModelCorrelator executive and the implementations of 
the subcomponents. A brief description of each item shown in Figure IV-3 follows the 
figure. A complete source code listing of the prototype Component Model Correlator 


module is included in Appendix A. 
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Figure IV-3. UML diagram showing the packages of the Component Model Correlator 
and the classes contained in each package. 


mil.navy.nps.cs.babel.connectors — An OOMI IDE package that contains the 
interfaces for all subcomponents of the OOMI IDE. The interfaces prevent high coupling 
between components and the OOMI IDE by establishing well-defined services. 


CMCorrelatorInterface — An interface that defines the services required by the 
Component Model Correlator Module. The methods associate directly to the use cases 


identified in Figure IV-1. 


mil.navy.nps.cs.babel.event — An OOMI IDE package that contains the event and 


event listener classes for all components of the OOMI IDE. Events and event listeners are 
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used in user interfaces as alternative execution paths to components rather than using 
explicit method calls through the subcomponents interface. An event is characterized as 
an interaction action between a user and the user interface. Examples of events include 
mouse clicks, mouse movement, and keyboard actions. A GUI control, such as a button or 
menu can be told to “listen” for particular events. When the event occurs, any class 


registered with the appropriate event listener act upon the event. 


CorrelatorPanelEvent — A class that defines the events associated with the 


Correlator panel. The specific events are discussed in Section IV.C.1. 


CorrelatorPanelEventListener — An interface that is implemented by the 
ComponentModelCorrelator class. It enables the Correlator to listen for events that take 


place within the Correlator Panel. 


mil.navy.nps.cs.babel.Correlator — A package containing the classes and interfaces 


of the Component Model Correlator module. 


CMCorrelatorAdaptor — A class that implements the CMCorrelatorInterface with 
methods that throw a “method not implemented” exception. The 


ComponentModelCorrelator class is a generalization of this class. 


ComponentModelCorrelator — The overall executive of the Component Model 
Correlator model. This class coordinates the use of the services contained in the sub- 
packages and handles the duties of sending information back to the OOMI IDE. It inherits 
from CMCorrelatorAdaptor and overrides the methods of the super class for which an 
implementation exists. Otherwise, CMCorrelatorAdaptor will throw a “method not 


implemented” exception. 


mil.navy.nps.cs.babel.Correlator.semanticComponentGenerator — The package 
containing the classes used to generate the semantic components required for the semantic 


search phase of the Component Model Correlator. 


KeywordGenerator — The interface defining the services for a keyword generator. 


A keyword generator creates a keyword list for a CCR and an FCR. The keyword list is 
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the semantic component required for the semantic correlation phase. The methodology for 


semantic component generation is discussed in Section IILC. 


KeywordGeneratorImpl — An implementation of a keyword generator, which 
generates the semantic components of a CCR and an FCR. This class implements the 


semantic component generation methodology outlined in Section III.C. 


mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator — The package 
containing the classes used to generate the syntactic components required for the syntactic 


search phase of the Component Model Correlator. 


DiscriminatorGenerator — The interface defining the services required for a 
discriminator vector generator as outlined in the syntactic component generation 
methodology discussed in Section I.D.1. A discriminator generator generates the 


discriminator vectors for a CCR or an FCR required for the syntactic correlation phase. 


DiscriminatorGeneratorImp! — An implementation of a discriminator vector 
generator, which generates the discriminator vectors for a CCR and an FCR. This class 


implements the methodology discussed in Section II.D.1. 


NeuralNetGenerator — The interface defining the services for a neural network 
generator. The neural network generator creates and trains a neural network for an FCR. 
The neural network is an additional syntactic component of an FCR used in the syntactic 


correlation phase as discussed in Section II.D.2. 


NeuralNetGeneratorImpl — An implementation of a neural network generator that 
creates and trains an FCR neural network. This class implements the methodology 


discussed in Section II.D.2. 


DiscriminatorVector — The interface defining the services for a discriminator 
vector utility class. This interface defines the property get/set methods of a discriminator 


vector as defined in Section III.D.1. 


DiscriminatorVectorImp! — An implementation of a discriminator vector utility 


class. This class contains the logic used for the creation of a discriminator vector as well 
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as the calculations required to normalize a vector. This class implements the methodology 


discussed in Section II.D.1. 


mil.navy.nps.cs.babel. Correlator.semanticSearchEngine — The package containing 
the component classes that implement the semantic search phase of Component Model 


Correlator. 


SemanticSearchEngine — The interface defining the services required for a 
semantic search engine. The semantic search engine performs the semantic correlation as 


discussion in Section III.E. 


SemanticSearchEnginelmpl — An implementation of a semantic search engine that 
performs the semantic correlation phase of the Component Model Correlator. This class 


implements the methodology discussed in Section IILE. 


mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine — The package containing 
the component classes that implement the semantic search phase of Component Model 


Correlator. 


SyntacticSearchEngine — The interface defining the services required for a 
syntactic search engine. The syntactic search engine performs the syntactic correlation as 


discussion in Section III.F 


SyntacticSearchEngineImpl — An implementation of a syntactic search engine that 
performs the syntactic correlation phase of the Component Model Correlator. This class 


implements the methodology discussed in Section III.F. 


mwa.ai.neural — The package from [Wat97] containing the neural network 


component classes used within the Component Model Correlator. 


Neural — An implementation of a backpropagation neural network adapted from 
[Wat97]. This class contains all methods for creating, training and using an instance of a 


neural network. 


NNFile — A utility input-output class that parses a Neural object to and from a 


specifically formatted file. 


69 


As defined in the architecture of Figure I[V-2, the four subcomponents of the 
Component Model  Correlator, semanticSearchEngine, — syntacticSearchEngine, 
semanticComponentGenerator, and syntacticComponentGenerator, are cohesive modules 
that decouple the implementation of these features from the user interface (UI) 
components of the OOMI IDE. The link between the Component Model Correlator 
module features and the OOMI IDE UI is the ComponentModelCorrelator. As stated, this 
class is the executive of the Correlator module and is coupled to the OOMI IDE UI by the 
CMCorrelatorInterface and the CorrelatorPanelEventListener. 


1. Classes in package mil.navy.nps.cs.oomi.babel.Correlator 


The classes contained in the Correlator package and their associations with other 
components of the OOMI IDE are shown in Figure IV-4. These classes provide the 
linkage between the OOMI IDE UI implementation and the ULindependent services of 
the Component Model  Correlator. The CMCorrelatorInterface in package 
mil.navy.nps.cs.oomi.babel.connector defines the core services the OOMI IDE expects 


from the ComponentModelCorrelator. 
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Figure IV-4. Class diagram of the Correlator package showing the important class 
methods. 


The CMCorrelatorAdaptor class is designed to assist in the software development 
process. It implements the CMCorrelatorInterface interface but throws the exception 
java.lang. UnsupportedOperationException for every operation defined in the interface. 
The OOMI IDE handles the exception by displaying an alert message stating that the 
operation being called has not yet been implemented. The ComponentModelCorrelator 
then extends the CMCorrelatorAdaptor and overrides only those operations with 
implementations. Using this technique, the features of the OOMI IDE UI provide 


feedback to the developers despite the fact that implementations may not exist yet. 


The implementation of the Component Model Correlator presented in this thesis 
allows the OOMI IDE to access the module features using two distinct paths. During the 
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Add Component System External Interface and Manage Federation Entities phases of the 
OOMI IDE, the features of the Correlator module are accessed through the 
CMCorrelatorInterface. However, during Register Component Class Representation 
phase, event listeners call the Correlator features. The ComponentModelCorrelator 
implements the CorrelatorPanelEventListener interface as shown in Figure IV-4. The 
class CorrelatorPanelEvent defines the common events associated with the component 
model correlator panel within the OOMI IDE. When a feature on the correlator panel is 
executed it fires a CorrelatorPanelEvent instance, which is then acted upon by the 
ComponentModelCorrelator. A more detailed discussion of the CorrelatorPanel user 
interface is provided in Section IV.C.1 


2; Modifications to the FIOM Framework 


The implementation of the Component Model Correlator required additions and 
modifications to the Federation Interoperability Object Model (FIOM) framework 
described in Section II.D.4 and originally developed by Lee [Lee02]. As shown in Figure 


IV-5, The FIOM framework is contained within the package mil.navy.nps.cs.oomi.fiom. 
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Figure [V-5. Additions and modifications to the FIOM framework. 


The original FIOM framework did not provide an implementation for the 
CCRSemantics, FCRSemantics, CCRSyntax, and FCRSyntax components. These 
components are required for the Component Model Correlator and have been 
implemented in this thesis. Additionally, the original CCR and FCR components did not 
include the composition associations for the CCRSemantics, FCRSemantics, CCRSyntax, 
and FCRSyntax components as indicated in Figure IV-5. As such, the composition 
associations have been included in the CCR and FCR components as well as a number of 


property get/set methods. Lastly, Semantics and Syntax components were added, to define 
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the services required by the CCRSemantics, FCRSemantics, CCRSyntax, and FCRSyntax 
components. The complete source code listing of the FIOM Framework additions and 
modifications is included in Appendix B. 
B. COMPONENT GENERATION 

1. XML IMPLEMENTATION Considerations 


As stated in Section II.C and HI.D, semantic and syntactic components for the 
Component Model Correlator are generated from a CCR XML Schema file or an FCR 
XML Schema file. Three XML processing APIs were evaluated for use in the 


implementation of the component model correlator. 


DOM The Document Object Model (DOM) is a platform and language neutral 
interface that allows programs and scripts to dynamically access and update the content, 
structure and style of documents. The DOM specification is a recommendation from the 
World Wide Web Consortium (W3C) and was first entitled DOM Level 1. The current 
version is DOM Level 3. [HH02] The DOM can be used with many types of documents 
and provides a means for working with documents in code. In terms of XML, developers 
can use the DOM to create XML documents or parts of XML documents, navigate 
through a document, and move, copy or delete parts of an XML document. As inferred 
from the name, the DOM represents the entire document, an important concept. This 
method enables fairly easy processing of an XML document. However, DOM requires a 
large amount of memory to represent an XML document, which can be critical in small 
footprint devices. [HCD+01] A big plus for DOM is that it takes a generic approach to 
modeling XML documents regardless of structure. The DOM is usually added as a layer 
between an XML parser and the application using the XML document as shown in Figure 
IV-6. An XML parser processes an XML document into the DOM representation. The 


application can then get information about the XML document using the DOM interfaces. 
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AMI. XML Parser 
Document 


Parse Get Information 


| . 








Application 


Figure [V-6. The DOM approach to obtaining information from an XML document. 
[HCD+01] 








SAX The Simple API for XML (SAX) is another approach to obtaining 
information about an XML document. SAX was developed in order to enable more 
efficient analysis of large XML documents than DOM can provide. As stated above, the 
DOM approach addresses the entire document. Before an application can use DOM to 
traverse an XML document, DOM builds up a massive in-memory map of the document 
that takes space and time. [HCD+01] The DOM approach is extremely inefficient if an 
application is attempting to extract a small amount of information. The SAX approach is 
event-driven. Rather than parse an XML document into DOM and then extract 
information, SAX instructs the parser to raise events when it finds bits of information 


desired, usually a specific XML tag. The SAX approach is shown in Figure IV-7. 


atti XML Parser 
Document 








Parse Information 


| 114 





Event 
Application Handlers 








Figure [V-7._ The SAX approach to obtaining information from an XML document. 
[HCD+01] 


The interesting aspect of SAX is that no one owns it. It is not a formal 


recommendation like DOM and it does not belong to any consortium, standards body or 


TS 


company. It was developed by a group of developers who were looking for a solution to 
incompatibilities between XML parsers. It survives because it is simple and it works. 
[HDC+01] Examples of events in SAX 2.0, the current version of SAX, include 
startElement, endElement, startDocument and endDocument. The use of SAX does not 
eliminate XML parsing. It merely prevents the large overhead associated with DOM and 
is appropriate when small bits of information need to be extracted from an XML 


document. 


JDOM JDOM provides a Java representation of an XML document for easy and 
efficient reading, manipulation, and writing. It has a straightforward API, is a lightweight 
and fast, and is optimized for the Java programmer. It's an alternative to DOM and SAX, 
although it integrates well with both DOM and SAX. JDOM is not a wrapper for the 
W3C's DOM. JDOM serves the same purpose as DOM, but is easier to use for Java 
programmers. Like DOM, JDOM is not an XML parser, it is a document object model 
that uses XML parsers to build documents. The default XML parser used by JDOM is the 
JAXP-selected parser from Sun Microsystems. However, JDOM can use nearly any 


parser. [HMO2] 


JDOM was chosen for use in the generation of the syntactic and semantics 
components of the Component Model Correlator. The OOMI IDE is responsible for 
parsing an XML document into the JDOM representation. The input to the Syntactic and 
Semantic Component Generators of the Component Model Correlator is a JOOM instance 
of the XML Schema. The component generation then uses the JDOM interfaces to 
traverse the document and extract the required information. A more detailed discussion of 
this process is given in Section IV.B.1 for the Semantic Component Generator and in 
Section [V.B.3 for the Syntactic Component Generator. 


2 Semantic Component Generator 


The = mil.navy.nps.cs.babel.Correlator.semanticComponentGenerator package 
contains the classes used to generate the semantic components required for the semantic 
correlation phase of the Component Model Correlator. The ComponentModelCorrelator 
executive uses these classes when semantic component generation is requested from the 


OOMI IDE. As shown in Figure IV-8, the semanticComponentGenerator contains the 
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KeywordGenerator interface, which defines the services for a keyword generator, and the 


implementation class KeywordGeneratorImpl.. 


mil.navy.nps.cs.babel.Correlator.semanticComponentGenerator 





interface 
KeywordGenerator 


+generatekeywords:String!} 





1 
KeywordGeneratorimpl 


#jdomDoc:Document 
#wordList: StringBuffer 


+generateKeywords:String] 





Figure IV-8. UML Class diagram of package semanticComponentGenerator. 


The generation of the semantic components for a CCR is conducted during the 
ADD Component System External Interface phase of FIOM construction. This process 


begins when the interoperability engineer (IE) clicks the “Generate Semantics” button as 


shown in Figure IV-9. 
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Figure [V-9. Initiating Semantic Component Generation for a CCR. 


As depicted in Figure IV-10, when the button is clicked, the OOMI IDE calls the 
generateCCRSemanticComponents method of the interface CMCorrelatorInterface, which 
iS implemented by the ComponentModelCorrelator class. The 
ComponentModelCorrelator then creates a KeywordGenerator instance. The meat of the 
keyword generation is contained within the generateKeywords method of the 
KeywordGenerator. This method takes a JOOM document representing the CCR or FCR 
as its only parameter and returns an array of Strings holding the values of the keywords. 
To extract the keywords from the JOOM document, generateKeywords calls the private 
method parseNode. This method is a recursive function that takes a JOOM element as its 
only parameter. The function traverses the JOOM document and analyzes each node 
encountered in accordance with the Table III-1 of Section III.C. Once the 
KeywordGenerator returns the string of keywords, the ComponentModelCorrelator then 
binds the String array to the FCR or CCR semantic component. The process for 
generating an FCR keyword list is identical, except that it is initiated during the Manage 
Federation Entities phase of the OOMI IDE. 
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Figure IV-10. UML Sequence diagram of semantic component generation. 
3. Syntactic Component Generator 


The = mil.navy.nps.cs.babel. Correlator.syntacticComponentGenerator package 
contains the classes used to generate the syntactic components required for the syntactic 
correlation phase of the Component Model Correlator. These components include the 
discriminator vectors for an FCR or CCR and the neural network for an FCR. Figure 
IV-11 shows the interfaces and classes of the syntacticComponentGenerator package. 
The ComponentModelCorrelator manages the generation of the syntactic components 
through the NeuralNetGenerator and DiscriminatorGenerator interfaces. Theses two 
interfaces define the primary methods needed to generate the syntactic components. The 
DiscriminatorVector interface and the DiscriminatorVectorImpl class encapsulate the data 


structure and logic for a single discriminator vector. The DiscriminatorVector interface 
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also. defines two 


extremely valuable 


methods, ValuesAsFloatArray() and 


ValuesAsDoubleArray(). These two methods are used to convert an instance of 


DiscriminatorVector into a format needed by the neural network. 


mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator 
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Figure [V-11. UML Class diagram of package syntacticComponentGenerator. 


The generation of the syntactic components for a CCR is conducted during the 
ADD Component System External Interface phase of FIOM construction. The 
interoperability engineer initiates the syntactic generation process by clicking the 


“Generate Syntactics” from “Add” tab in the IDE as shown in Figure IV-12. 
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Figure [V-12. Initiating Syntactic Component Generation for a CCR 


Of note, the generation of the syntactic components can occur before or after the 
generation of the semantic components. When the “Generate Syntactics” button is 
clicked, the OOMI IDE uses’ the CMCorrelatorInterface to access the 
ComponentModelCorrelator method generateCCRSyntacticComponents, which takes a 
JDOM document of the CCR XML Schema as a_ parameter. The 
ComponentModelCorrelator then creates an instance of DiscriminatorGeneratorImpl and 
calls the generateDiscriminatorVectors method. This method traverses through the 
JDOM document and builds discriminator vectors in accordance with the discriminator 
vector schema defined in Section III.D.1. The method then returns a Java List that 
contains an individual float array for each attribute of the CCR. Each float array contains 
the normalized values of an attribute discriminator vector. The list of discriminator 
vectors is then associated with the CCRSyntax component for use in the syntactic 


correlation process. Figure IV- 13 illustrates the process. 
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Figure IV-13. UML Sequence diagram showing syntactic component generation for a 
CCR. 


The generation of the syntactic components for an FCR is conducted during 
Manage Federation Entities phase of the OOMI IDE and follows the same initial steps as 
syntactic component generation for a CCR. Once the discriminator vectors for an FCR 
have been generated, the ComponentModelCorrelator creates an instance of 
NeuralNetGeneratorImpl and calls the generateNueralNet method. This method takes a 
list of discriminator vectors as its only parameter and returns a trained, backpropagation 
neural network. The neural network is then saved as a file using the NeuralNetGenerator 
method makeFile. The makeFile method takes a trained neural network and an absolute 
file path as its parameters and returns a boolean if the file has been created successfully. 
The neural network file path and the instance of the neural network are then associated 
with the FCRSyntax component for use in the syntactic correlation process. Figure IV-14 


illustrates the process for an FCR. 
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Figure IV-14. UML Sequence diagram showing syntactic component generation for an 
FCR. 


Cc CORRELATION 


1. Correlator Panel 


Component model correlation within the OOMI IDE is conducted during the 
Register Component Class Representation (CCR) phase from the Correlator Panel. The 
Correlator Panel is shown in Figure [V-15 within the dashed rectangular border. The 
Correlator Panel is implemented as a Java JPanel and is a component of the “Register” 


tab. 
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Figure [V-15. The correlator panel of the OOMI IDE. 


The Correlator Panel includes a number of features important to the 
interoperability engineer. The table in the lower portion is used to display the results of 
the correlation process. The “Preferences” button can be clicked to set various parameters 
used in the correlation process such as the learning rate, maximum iterations and error 
tolerance for the neural network training process. Drop down boxes are provided so 
threshold settings can be set for each phase of the correlation process. The “Keyword” 
button is used to launch the semantic correlation phase and the “Neural Net” button is 
used to launch the syntactic correlation phase. The “Combined Score” button filters the 


correlation results by the combined keyword and neural network score of an FEV. 


As stated in Section IV.A.1, the ComponentModelCorrelator presented in this 
thesis implements the CorrelatorPanelEventListener interface shown in Figure IV-4. The 
class CorrelatorPanelEvent defines the common events associated with the component 
model correlator panel within the OOMI IDE. When a feature on the correlator panel is 
selected it fires a CorrelatorPanelEvent instance that is then acted upon by the 


ComponentModelCorrelator. The CorrelatorPanelEvent class defines five events: 


e PREFERENCES BUTTON PRESSED — This event is fired when the 
“Preferences” button is clicked. The CorrelatorPanelEventListener then calls 


the panelEventOccurred method of the ComponentModelCorrelator. The 
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ComponentModelCorrelator handles the event through a switch block and calls 


the setPreferences method. 


KEYWORD_BUTTON_PRESSED -— This event is fired when the “Keyword” 
button is clicked. The CorrelatorPanelEventListener then calls the 
panelEventOccurred method of the ComponentModelCorrelator. The 
ComponentModelCorrelator handles the event through a switch block and calls 
the doSemanticSearch method. The doSemanticSearch method initializes and 
manages the semantic correlation as described in Section HI.E and displays the 


results in the Correlator Panel results table. 


NEURAL NET _BUTTON_PRESSED — This event is fired when the ‘Neural 
Net” button is clicked. The CorrelatorPanelEventListener then calls the 
panelEventOccurred method of the ComponentModelCorrelator. The 
ComponentModelCorrelator handles the event through a switch block and calls 
the doSyntacticSearch method. The doSyntacticSearch method initializes and 
manages the semantic correlation as described in Section III.F and displays the 
results in the Correlator Panel results table alongside the semantic correlation 


results. 


SHOW_FEV_BUTTON_PRESSED — This event is fired when the “Show 
FEV” button is clicked. The CorrelatorPanelEventListener then calls the 
panelEventOccurred method of the ComponentModelCorrelator. The 
ComponentModelCorrelator handles the event through a switch block and calls 
the showFEV method. This method displays a selected results FEV to the 
display area above the Correlator Panel on the “Register” tab. This allows the 
interoperability engineer to examine any FEV and make a final determination 


as to its correspondence to a candidate CCR. 


CCR_SELECTED — This event is fired when the “Keyword” button is clicked. 
The CorrelatorPanelEventListener then calls the panelEventOccurred method 
of the ComponentModelCorrelator. The ComponentModelCorrelator handles 
the event through a switch block and calls the updateCCRList method. This 
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method sets the candidate CCR attribute to the CCR selected in the 
combination box. 


2. Semantic Correlator 


The mil.navy.nps.cs.babel.Correlator.semanticSearchEngine package contains the 
classes that implement the meat of the semantic correlation process. As shown in Figure 
IV-16, the package contains only one interface, SemanticSearchEngine, which is used by 
the ComponentModelCorrelator to conduct the semantic correlation. The class 


SemanticSearchEnginelmpl provides an implementation for the interface. 


mil.navy.nps.cs.babel.Correlator.semanticSearchEngine 


interface 
SemanticS earchEngine 


+runSemanticSearch: Object} 


i\ 


| 
SemanticSearchEnginelmpl 


+runSemanticSearch:Object)]] 
-runComparisonF orScore-float 
-sortResults:void 





Figure IV-16. UML Class diagram of package semanticSearchEngine 


The interoperability engineer initiates the semantic correlation process by clicking 


the “Keywords” button from Correlator Panel as shown in Figure IV-12. 
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Figure [V-17. Initiating the semantic correlation process. 


The doSemanticCorrelation method of the ComponentModelCorrelator is then 
called and the semantic correlation process begins. A UML Sequence diagram describing 


the semantic correlation process is shown in Figure IV-18. 
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Figure [V-18. UML Sequence diagram showing the semantic correlation 


87 


The doSemanticCorrelation() method takes control of the semantic correlation 
process. An instance of SemanticSearchEnginelmpl is created and the runSemanticSearch 
method is called. The runSemanticSearch method takes a list of FCRs as one parameter 
and the candidate CCR as the second parameter. The SemanticSearchEngine then 
executes the semantic correlation algorithm in accordance with the methodology discussed 
in Section IIL.E. Once the semantic correlation is complete, the 
SemanticSearchEnginelmpl returns a two dimensional array of results to the 
ComponentModelCorrelator. The two dimensional array contains a mapping for each 
element consisting of the name of the FCRs evaluated and the associated semantic 
correlation score for the FCR. These results are then passed to the Correlator Panel and 
displayed in the results table. 


3. Syntactic Correlator 


The mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine package contains the 
classes that implement the meat of the syntactic correlation process. As shown in Figure 
IV-16, the package contains only one interface, SyntacticSearchEngine, which is used by 
the ComponentModelCorrelator to conduct the syntactic correlation. The class 


SyntacticSearchEnginelmpl provides an implementation for the interface. 
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mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine 
interface 
SyntactcSearchEngine 
+runsyniacticSearch-Object}} 


| 
SyntacticSearchEnginelmpl 


+runSyntacticSearch:Object9J 
-runComparisonForScore:float 
-sornResults:void 





Figure IV-19. UML Class diagram of package syntacticSearchEngine 


The interoperability engineer initiates the syntactic correlation process by clicking 


the “Neural Net” button from the “Register” tab in the IDE as shown in Figure IV-12. 


GJ Babel - Federation Management and Component System Integration Tool 


File FIOM Help 

app| wowace ron GENERATE | 

REGISTER Compot@iit@tass Representation 

Resist cor | p | > | — | Add Translation 





=/Olx! 





AddView | AddFCR 











Show FIOM | showte| snow ev | 








component System Classes 
® «CCR Directory Structure 














Threshold Values:|70 vii70 vii70 


Compoenent Class Selected: Filter On: Keywords Neural Net _Jbombined Score - 
| Preferences ir Show FE 
Ee v 





FEV Keyword Score Pass-Thru Neural Net Score Combined Score Select FE 





























Register Component Class Represntation 





CCR Semantic Components Generated 











Figure [V-20. Initiating the syntactic correlation process. 
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The doSyntacticCorrelation method of the ComponentModelCorrelator is then 
called and the syntactic correlation process begins. A UML Sequence diagram describing 


the syntactic correlation process is shown in Figure IV-18. 
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Figure [V-21. UML Sequence diagram showing the syntactic correlation 


The doSyntacticCorrelation method controls the syntactic correlation process. An 
instance of the SyntacticSearchEngine is created and the runSyntacticSearch method is 
called. The runSyntacticSearch method takes a list of FCRs as one parameter and the 
candidate CCR as the second parameter. The SyntacticSearchEngine then executes the 
syntactic correlation algorithm as discussed in Section III.F. Similar to the semantic 
search engine, the SyntacticSearchEngineImp! returns a two dimensional array of results 
to the ComponentModelCorrelator. The two dimensional array contains a mapping for 
each element consisting of the name of the FCRs evaluated and the associated syntactic 
correlation score for the FCR. These results are then passed to the Correlator Panel and 


displayed in the results table. 
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Vv. CONCLUSIONS 


A. PRELIMINARY RESULTS 


A small test set of five XML schemas, based on the systems in Figure I-1 of 
Section II.A.3, was created to test the prototype of the Component Model Correlator. The 
XML Schemas are listed in Appendix D. Of these five schemas, two define Component 
Class Representation (CCR) schemas and three define Federation Class Representation 
(FCR) schemas. The schemas were used by the Component Model Correlator to generate 
the semantic and syntactic components required for each phase of component model 
correlation. After the generation of the semantic and syntactic components, each CCR 
was semantically and syntactically correlated to the set of three FCRs. The results for 
each phase of the correlation are presented in the following sections. To summarize, the 
preliminary results are inconclusive and do not provide enough data to evaluate the 
component model correlation methodology or the Component Model Correlator prototype. 
The major reason for the inconclusive results is the small set of federation entities created 
for the tests. In order to better evaluate the Component Model Correlator prototype and 
the component model correlation methodology, a robust set of federation components is 
required. The creation of a large test set of federation components is left as a subject for 
future work. 


1. Semantic Correlation Results 


The preliminary results of the semantic correlation phase for each CCR are shown 
in Table V-1. By test design the armoredFightingVehicle CCR should correlate with the 
groundCombatVehicleView3 FCR. Also, the mechanizedCombatVehicle CCR should 
correlate with the groundCombatVehicleView] FCR. As shown, the semantic correlation 


is successful in correlating the test CCRs to the test design FCRs. 
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Table V-1. Preliminary semantic correlation results. 


FCR Results 
armoredFighting Vehicle groundCombatVehicleView3: 75.4 
groundCombatVehicleView?2: 67.2 
groundCombatVehicleView 1: 67.2 


mechanizedCombatVehicle groundCombatVehicleView 1: 58.9 
groundCombatVehicleView3: 55.2 
groundCombatVehicleView2: 55.2 





Despite an apparently successful semantic correlation, the percentage results for 
the mechanizedCombatVehicle in Table V-1 are lower than originally anticipated. As a 
results, an additional test was conducted using a slight modification in the methodology 
for generating the semantic components discussed in Section III.C. The original 
methodology uses seven XML Schema fields for keyword generation. ‘These fields and 
their descriptions are listed in Table III-1. In the second test, five of the seven fields were 
eliminated from the keyword generator leaving only the xsd:documentation and 
xsd:enumeration fields. Table V-2 shows the results of the semantic correlation 
conducted with the modified semantic components. In this test case, the FCR results for 
each CCR increase dramatically while still returning the expected design results. 
Although interesting, the results are inconclusive given the small training set and cannot 
be used to suggest a change in the methodology of Section III.C. As stated, a larger set of 


federation components is needed to fully validate the Component Model Correlator. 


Table V-2. | Semantic correlation results with modified semantic components. 


FCR Results 
armoredFighting Vehicle groundCombatVehicleView3: 91.4 
groundCombatVehicleView2: 77.1 
groundCombatVehicle View 1: 77.1 


mechanizedCombatVehicle groundCombatVehicleView1: 97.1 
groundCombatVehicleView3: 91.4 
groundCombatVehicleView2: 91.4 
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Ze Syntactic Correlation Results 


The preliminary results of the semantic correlation phase for each CCR are shown 
in Table V-3. As with the semantic correlation test, the armoredFighting Vehicle CCR 
should correlate with the groundCombatVehicleView3 FCR_ and __ the 
mechanizedCombatVehicle CCR should correlate with the groundCombatVehicleView1 
FCR. As shown, these results were not obtained in the semantic correlation phase. 
Instead, the armoredFighting Vehicle syntactically correlated to the 
groundCombatVehicleView] FCR and the mechanizedCombatVehicle syntactically 
correlated to groundCombatVehicleView3 FCR. The syntactic correlation of Table V-3 
did not use the one-to-one correspondence method for reducing false-positives as 
described in Section II.F. Interestingly, no results are returned for either CCR with the 
one-to-one correspondence check in place. This means that despite the 95 and 94 percent 
syntactic correlation scores in Table V-3, the correlation were not one-to-one. Again, this 


is not the desired result. 


Table V-3. Preliminary syntactic correlation results. 


FCR Results 
armoredFighting Vehicle groundCombatVehicleView2: 94.2 
groundCombatVehicleView1: 93.5 
groundCombatVehicleView3: 88.4 


mechanizedCombatVehicle groundCombatVehicleView3: 95.3 
groundCombatVehicleView1: 94.1 
groundCombatVehicleView2: 82.9 





Despite the failure to achieve the expected correlations, the preliminary results for 
the syntactic correlation are inclusive. It is not clear if the failure is a part of the 
methodology or a part of the test design. An analysis of the raw discriminator vectors 
generated by the Syntactic Component Generator suggests that the Syntactic Correlator is 
performing correctly and that perhaps the test design and test XML schemas are flawed. 
For example, visual inspection shows that the discriminator vectors for the 
mechanizedCombatVehicle are closer in value to the groundCombatVehicleView3 FCR 
than they are to any other FCR. This indicates that the XML Schemas may have been 


created incorrectly. Although the schemas provide the correct semantic results, they were 
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not created to give consistent syntactic correlation results. In order to accurately assess 
the syntactic correlation process and the prototype presented, a robust set of test federation 
components is required. In addition, syntactic correlation tests must include designed 


successful correlations and designed failures. 
B. NEURAL NETWORK CONSIDERATIONS 


As discussed in Section [I.D.2, a backpropagation neural network is one of the 
syntactic components generated for an FCR. During the generation process, the network 
is trained using the FCR’s discriminator vectors and a set of binary output vectors 
representing the FCR’s attributes. The training process for a neural network can be time 
consuming and resource intensive. Hence, a balance must be achieved between the effort 
to train a network for correct responses and the effort to train for good responses. Several 


factors address this balance: 


Choice of initial weights — The choice of initial weights will influence whether the 
net reaches a global minimum of the output error and, if so, how quickly it converges on 
the desired output. It is important to avoid choices of initial weights that would make it 
likely that either a nodes activation function or its derivative is zero. Also, the initial 
values cannot be too low or too high where the values approach the upper and lower 
bounds of the sigmoid function. With weight values in these regions, training can be very 


slow. [Fau94] 


Learning rate — The learning rate is a parameter that controls the amount by which 
weights are changed during training. In a backpropagation neural network, the learning 
rate remains constant throughout the training process. A low learning rate increases the 
time required to train the network since the adjustments to weights occur in small 
increments. However, the lower learning rate usually results in a lower output error and 
better-trained network. Conversely, a high learning rate will decrease training time but 


result in a higher output error. [Fau94] 


Maximum Error Tolerance — The maximum error tolerance is the maximum 
valued for the mean squared error of the neural network output during training. The mean 


squared error is defines as the sum of the squared node output errors divided by the 
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number of input training patterns. If the maximum error tolerance is set too low, the 
training cycle may take a long time to train, although the trained network will produce 
better results. Conversely, if the error tolerance is set too high, the network will train 
faster, but with less accurate matching capability. [Fau94] The maximum error tolerance 
and maximum epochs factor work in conjunction with each other to limit the training time 


for a neural network. 


Node input bias — A node input bias can assist the network in training when many 
of the input training values are at the bound of the sigmoid function, which for an FCR is 
either 0.0 or 1.0. The node input bias is a term which is included in the net input for node 
j along with the sum of all weighted inputs from all nodes connected to node j. This 
provides an input to node j that can be propagated with the nodes activation function. 


[Fau94] 


Maximum epochs — An epoch is one presentation of the set of input training 
vectors to the neural network. Since the network must produce the set of desired outputs 
for the set of training input, cycles of training are characterized as epochs. The maximum 
number of epochs setting limits the training epochs for a neural network should the 


maximum error tolerance not be achieved. 


The implementation of the syntactic component generator presented in Section 
IV.B.3, addresses neural network training factors in a cursory manner in order to prove the 
concept of syntactic correlation. The value or method used for each factor is shown in 
Table V-4. In future work, the Component Model Correlator should be revised to 


optimize these neural network training factors. 
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Table V-4. | Neural network training factors used in the Component Model Correlator 
implementation. 


Initial Weight Values Random numbers in range [-0.5, 0.5] 


Learning rate 0.25 


Max Error tolerance 0.01 


Max Epochs 100,000 


C; THE ROLE OF COMPONENT MODEL CORRELATION 





The component model correlation methodology and component model correlator 
presented in this thesis provide a viable solution to model correspondence within the 
OOMI IDE. The introduction of automated component model correlation is a significant 
benefit of the OOMI IDE over other methods of interoperability such as CORBA or Java 
Enterprise. [You02] Correlation automation saves interoperability engineers countless 
mar-hours during the process of integrating systems and enables new components to be 


added to a federation in a relatively short amount of time. 


The two-phase approach to correlation provides mechanisms to increase the recall 
and precision of the search space. The semantic search process capitalizes from a 
straightforward classical keyword matching approach that allows for flexibility and 
adaptation. Improvements or changes to the keyword search algorithm can be 
incorporated into the component model correlator with ease. The syntactic search process 
utilizes advanced artificial intelligence methods to compare the structure of component 
and federation data models to locate an entity correspondence. In varying 
implementations, these two processes can be adapted for mult+threading or can be placed 


in a pipeline architecture with little change to the underlying code. 


With the component model correlator module, the Object-Oriented Method for 


Interoperability is a step in the right direction in providing a concrete methodology and 
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framework to make interoperability a reality, not just a concept in a white paper. This 
moves the Department of Defense closer to the Quadrennial Defense Review goal of 
having systems that can immediately "plug" into other joint battlefield operating systems. 


D. RECOMMENDATIONS FOR FUTURE RESEARCH 


At the time of this writing, the OOMI IDE toolset is far from completion. The 
Interoperability Working Group at the Naval Postgraduate School continues to develop the 
features of the IDE and research future directions. One item of discussion is the 
possibility of using a native XML database to store FIOM objects. Another topic is the 
use of XML data binding and Java reflection to build the semantic and syntactic 
components rather than parsing through an XML Schema. An exciting future area of 
research is the idea of a distributed OOMI IDE, which would distribute the components of 
the FIOM to clusters of users. 


L Test of Component Model Correlator with a large set of federation 
components. 


As discussed in Section V.A, the preliminary test results for the semantic and 
syntactic correlation implemented in the Component Model Correlator prototype are 
inconclusive and do not provide enough data to evaluate the methodology or the 
prototype. Two possible reasons for the inconclusive result are the small number of 
federation test components and the possible flawed construction of the XML test Schemas. 
In order to accurately assess the Compone nt Model Correlator methodology, a large set of 
federation components is required. The testing of the correlator methodology and 
prototype would be extremely valuable in accurately assessing the benefits of the 
Component Model Correlator. 


2. XML Documents for Semantic and Syntactic Components. 


The use of XML documents to provide persistent storage for semantic and 
syntactic components used for the component model correlator is a natural improvement 
over the implementation described in this thesis. For example, the keyword lists and 
discriminator vectors for a CCR and FCR can easily be stored in XML documents. 
Similarly, the neural network file can be changed from the format described in Section 


IV.F to a more streamlined XML format. Future work could address the use of XML 
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documents and a native XML database to store the objects of an FIOM. An example of a 
native XML database is the Apache Xindice project. [XINO2] A benefit of using a native 
XML database is the reduction in the amount of work required to map XML to some other 
data structure. Instead, data is inserted into the database as XML and retrieved as XML. 
There is also a lot of flexibility through the semi-structured nature of XML and the 
schema independent model used by Xindice. This is especially valuable with very 
complex XML structures that would be difficult or impossible to map to a more structured 
database. 


2. Semantic and Syntactic Component Generation Using Java Reflection 


In the original component model correlation methodology described by Young, 
semantic and syntactic components were generated from FCRSchema and CCRSchema 
classes defined within the FIOM Framework. [You02] These Java objects are created 
using XML data binding. XML data binding is the process of mapping an XML 
document to its in-memory object representation. The conversion of an XML document 
into Java objects is called unmarshalling. In theory, once a Java object(s) exist for an 
XML document, Java reflection could be used to capture the semantic and syntactic 
information required by the component model correlator. Current methods for conducting 
XML data binding do not capture the full spectrum of data contained in an XML Schema. 
Future improvements to XML data binding technology might enable the use of Java 
reflection. Future work could refine the use of Java reflection in order to create the 
semantic and syntactic components directly from memory rather than from XML 
Schemas. 


4. Object Correlation in a Distributed OOMI IDE Architecture 


A distributed OOMI IDE introduces many complex issues into an already complex 
tool set. Component model correlation in a distributed environment may or may not be a 
problem. In one view, the component model correlator module could reside on each 
system within the distributed environment. When correlation is performed, the requesting 
system could send a request to the distributed correlator modules to find FCR matches. In 
this type of distributed environment, the features of the component model correlator would 


need only minor improvements given their low coupling to the OOMI IDE. In another 
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view, the distributed OOMI IDE would still require an executive that would oversee all 
correlation between the various systems. In this case, the correlator module may need 
more rework. Future work in this arena could include the design and implementation of a 


distributed Component Model Correlator. 
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APPENDIX A. COMPONENT MODEL CORRELATOR SOURCE 


A. PACKAGE: mil.navy.nps.cs.babel.correlator.semanticComponentGenerator 
if Interface KeywordGenerator 

J [KKK RK KK KK RA II KA AA A ee IIIA AAA A ke ee IAA AA Ae ee IA A A A A ee oe oe 

[fe BUVENAMEE 2 siete sos aed KeywordGenerator. java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 

// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

Jif OREO Bs i aso ei eek ek ee LT Steve Shedd, USN 

/f/ COMPANY $34 F4w a eee ae Naval Postgraduate School, Monterey, California 

fo DatG tis en swe Mee September 2002 


J [BRR KR KK KK KK A KKK AAR A Ae AAA A A Ae ee IAA AA A ke ee A A A A A He He oe oe 


package mil.navy.nps.cs.babel.Correlator.semanticComponentGenerator; 


import org. jdom.JDOMException; 
import org. jdom.Document; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK kK KK KKK KK KK KK KKK KK 
* <br> 

The <i>KeywordGenerator</i> interface defines the services that a keyword 

generator must provide to the component model correlator. The class 
<i>ComponentModelCorrelator</i> uses this interface to instantiate the keyword 

generator. 


@author LT Steve Shedd 
@version v1.0 September 2002 


+ £ + F HF F HF 


KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KKK KK KK KKK KK KK KK */ 


public interface KeywordGenerator 


{ 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK 
* <br> 

Returns an array of keywords extracted from the JDOM document 

passed in as a parameter. 


@param jdom —- A JDOM Document created from a well-formed XML Schema 
@return A String array containing the keywords from the JDOM Document. 
@throws JDOMException - if the jdom parameter is null or if there are any 
other JDOM problems. 


@author LT Steve Shedd 


x + + FH H FE 


KKKKKK KKK KKK KKK KK KK KK KK KK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public String[] generateKeywords( Document jdomDoc ) throws JDOMException; 


} // End KeywordGenerator 


Zs Class KeywordGeneratorImpl 


J [BRR RR KKK KK KI A KKK AAR A A AAA AAA Ae IAA AA A A IA AA A A He He He oe 


// Filenamed ac. ew ee ews KeywordGeneratoriImpl. java 

// Parent PYOUEGE toe cece 5 SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

ff PUCHOL ii eh ede bs STs LT Steve Shedd, USN 

Jf “Company Basene deceeseiee 8 Naval Postgraduate School, Monterey, California 

Pf DAE Sie oo gs og agg aig oS September 2002 
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J [BRR KR KK KK KK A KK AAA A ee AAA AA kee IAA AA A ke ee IIIA A A A A ee oe oe 


package mil.navy.nps.cs.babel.Correlator.semanticComponentGenerator; 


import java.util.List; 

import java.util.Iterator; 

import java.util.Vector; 

import java.util.ArrayList; 
import java.util.StringTokenizer; 
import java.util.Arrays; 

import java.util.TreeSet; 

import java.util.Comparator; 


import org. jdom.JDOMException; 

import org. jdom.Document; 

import org. jdom.JDOMException; 

import org. jdom.transform.JDOMSource; 
import org.jdom. input .SAXBuilder; 
import org. jdom.Element; 

import org. jdom.Attribute; 

import org. jdom.Namespace; 








[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK ok kk kk KK KK KK KK KK KKK KKK 
* <br> 

The <i>KeywordGeneratorImpl</i> class extracts keyword information from an XML 

document passed into the <i>generateKeywords</i> method. 


@author LT Steve Shedd 
@version v1.0 September 2002 


+ * * F 


* 


KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK */ 


public class KeywordGeneratorImpl implements KeywordGenerator 


{ 


/** Member variable to hold the JDOM Document used in the parsing. */ 
private Document jdomDoc = null; 


/** Data structure to build a raw keyword list */ 
private StringBuffer wordList = new StringBuffer (); 


/** Final array of keywords generated from the JDOM Document */ 
private String[] keywordList = null; 





/** Root Element of the JDOM Document */ 
protected Element docRoot = null; 


/** Namespace used within the JDOM Document */ 
Namespace docNamespace = null; 


/** Default constructor */ 
public KeywordGeneratorImpl () 
{ 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 


* <br> 

* Returns an array of keywords extracted from the JDOM document passed in as 
* a parameter. The method is a requirement from the interface 

* <i>KeywordGenerator</i>. 

* 

* @param jdom -—- A JDOM Document created from a well-formed XML Schema 
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@return A String array containing the keywords from the JDOM Document. 
@throws JDOMException - if the jdom parameter is null or if there are any 
other JDOM problems. 


@author LT Steve Shedd 
@version 1.0 


+ 4 * * F 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKK */ 


public String[] generateKeywords( Document jdom ) throws JDOMException 
{ 


// veset the results variables 
wordList = new StringBuffer (); 
keywordList = null; 


// Check to see if a null Document has been passed into the method 
if ( jdom == null ) 
{ 


throw new JDOMException( "Null pointer to JDOM Document", 
new NullPointerException() ); 


} 


// Create a local copy of the JDOM Document 
this.jdomDoc = new Document ( jdom.getContent() ); 


// Identify root element of JDOM document and get the schema namespace 
this.docRoot = jdom.getRootElement (); 
this.docNamespace = this.docRoot.getNamespace (); 


// Call the recursive function parseNode with JDOM root element. 
parseNode( this.docRoot ); 


// Filter the raw keyword results to get rid of clutter words and other 
// bogus characters. 
String[] results = filterRawKeywords( this.wordList ); 





// Return the filtered list of keywords 
return results; 


} // End generateKeywords 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 
* <br> 
* A recursive function that parses through the elements of the 
JDOM Document. The 
initial element parameter should be the document root of the 
JDOM document. The 
method will then recursively walk through the children of each 
element and call 
the <i>evaluateNode</i> method. 


@param root - a root element of the JDOM document. 
@return None 


@author LT Steve Shedd 
@version 1.0 


4 + * + + HF + + FH HF * 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK EK */ 


private void parseNode( Element root ) 


{ 


// Get a list of children under the root element parameter 
List kids = root.getChildren(); 


// Get an iterator for the kids list 
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} 


Iterator kidsIter = kids.iterator(); 


while ( kidsIter.hasNext() ) 

{ 
// for each child, extract the JDOM Element from the list that 
// vepresents the child. 
Element childNode = ( Element )kidsIter.next (); 


// Evaluate the element for keywords 
evaluateNode( childNode ); 


// then call the recursive method to look for grandchildren 
parseNode( childNode ); 


// End parseNode 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


<br> 

Evaluates a node of the JDOM document and determines whether or not 

to add keywords to the components keyword list. This method implements 
the logic of the keyword generator as defined in the semantic component 
generation methodology. 


@param node - A JDOM element from which keywords may be extracted. 
@return None 


@author LT Steve Shedd 
@version 1.0 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


private void evaluateNode( Element node ) 


{ 


String localName = node.getName(); 


// The if blocks below check the type of JDOM element being evaluated. 
// For each type, specific attribute keywords are extracted. Or, in the 
// case of the documentation element, the contents of the element are 

// extracted. A space is added to the end of each append call in order 
// to facilitate filtering in the filterRawKeywords method. 


if ( localName.toLowerCase().equals( "element" ) ) 





this.wordList.append( node.getAttributeValue( "name" ) + " " ); 
this.wordList.append( node.getAttributeValue( "type" ) +" " ); 
this.wordList.append( node.getAttributeValue( "ref" ) + " " ); 


if ( localName.toLowerCase().equals( "documentation" ) ) 


this.wordList.append( node.getTextNormalize() +" " ); 


if ( localName.toLowerCase().equals( "enumeration" ) ) 


this.wordList.append( node.getAttributeValue( "value" ) +" " ); 


if ( localName.toLowerCase().equals( "attribute" ) ) 


this.wordList.append( node.getAttributeValue( "name" ) +" " ); 


if ( localName.toLowerCase().equals( "simpleType" ) ) 





this.wordList.append( node.getAttributeValue( "name" ) +" " ); 
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ef 


} // end of evaluateNode 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* <br> 

* Returns a filtered list of keywords extracted from the 

* XMLSchema document. This 

* method is intended to be used to filter out clutter words and 
* characters from the 

* raw string buffer. This version performs simple filtering for simple 
* characters anda 

* small set of noise words. This method should be developed to 
* include more common 

* english words that could be considered clutter. x 

* 


@param words - a StringBuffer containg all the keywords extracted 
from an XML Schema. 
@return An array of individual keywords. 


* 
* 
* 
* 
* @author LT Steve Shedd 
* @version 1.0 

* 
* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK EKK */ 
private String[] filterRawKeywords( StringBuffer rawWords ) 


{ 


// Need a temporary data structure that can grow dynamically. The 
// TreeSet class gives the added benifit of eliminating duplicate 
// values and conducting an insertion sort on new elements. 
TreeSet tempResults = new TreeSet (); 


// The final array that will be passed back to the caller 
String[] results = null; 


// Convert the input string buffer to one large string 
// in order to make use of the String.replace method 


String words = 





rawWords.toString(); 


words = words.replace( '_', ' ' ); // cemove underbars 

words = words.replace( ':', ' ' ); // remove colons 

words = words.replace( ';', ' ' ); // xcemove semi-colons 

words = words.replace( '"' a // remove all double quotation marks 
words = words.replace( '.', ' ' ); // remove all periods 

words = words.replace( ',', ' ' ); // remove all commas 

words = words.replace( '(', ' ' ); // remove all left parenthesis 

words = words.replace( ')', ' ' ); // vemove all right parenthesis 

words = words.trim(); // remove spaces at beginning and end 


// Create a string tokenizer so we can extract 
// keywords from the words string. 


StringTokenizer st = 


individual 


new StringTokenizer( words ); 


// Iterate through the String and extract individual keywords 


while 


{ 


// Add the word to our list 


( 


st .hasMoreTokens () 


) 


tempResults.add( st.nextToken () 


// The next section of code checks the words in the temp results to 
// see if we should exclude any from the final results. 


Iterator tempResultsIter = 


int counter = 


while 


tempResults.iterator(); 


tempResults.size(); 


( tempResultsIter.hasNext () 
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String word = ( String )tempResultsIter.next () ; 


if ( inExclusionList( word ) ) 
{ 


tempResults.remove( word ); 


// Since there has been a change to the list, we 
//need to get a new iterator 
tempResultsIter = tempResults.iterator(); 


} 


// Size the final results String array 
results = new String[ tempResults.size() ]; 


// Convert the temporary list of keywords to an array of strings 
results = ( String[] ) tempResults.toArray( results ); 


// veturn the sorted string array of keywords 
return results; 


} // End filterRawKeywords 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
a <br> 
* Returns true if the word to check is in the exclusion list, 
false otherwise. The 
exclusion in this version is only an example. A deplyable version 
would most likely 
open an exculsion list file that would contain thousands of words 
that would clutter 
a list of keywords. 


@param wordToCheck - the string to search for in the exclusion list. 
@return True if the word is in the exclusion list, false otherwise. 


@author LT Steve Shedd 
@version 1.0 


t+ + + + FF HF FH FF HF F 


* 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


private boolean inExclusionList( String wordToCheck ) 


{ 
boolean result = false; 


// Very small example set of words to exclude from the keyword list. 

// Tf the list is larger, it would be better to use a binary search 

// tree as the data structure. 

String[] exclusionList = { "and", "but", "or", "nor", "in", "on", "while", 
"how", "when", "where", "why", mre, "were us "was", 
"iS", "has", "had", MOL; Wan, "Che", "to", “nuk, 
WEOr"; "an", Tehas', "that", "which", "what", "as"}; 


for ( int i = 0; i < exclusionList.length; i++ ) 
{ 
if ( ( ( String )exclusionList[i] ).equalsIgnoreCase( wordToCheck ) ) 
{ 
result = true; 
break; 


return result; 


} // End inExclusionList 
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// 
// 
// 
// 
// 
// 


// End KeywordGeneratorImpl 


PACKAGE: 
mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator 


ie Interface DiscriminatorGenerator 
J [RK KR KK KK KR I KKK ee AAA AAA ee IAA AAA A ee IAA A A A He oe oe oe 
Filename t.ccsceww ee veo DiscriminatorGenerator. java 
Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 
Original Compiler:....Sun JDK 1.3.1_04 
AUCH OL So yacesrees: Boe ieneet! 6 LT Steve Shedd, USN 
Company:............-- Naval Postgraduate School, Monterey, California 
DAU SS ieits-osacwa a de ee ae September 2002 


// 


J [BKK RK KK KKK A KAA AA A ee AAA A A ee IAA AA A ke ee IIA A A A Ae ee oe oe 


package mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator; 


import java.util.List; 


import org. jdom.JDOMException; 
import org. jdom.Document; 


/** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


<br> 

The <i>DiscriminatorGenerator</i> interface defines the services 

that a discriminator 

vector generator must provide to the component model correlator. The class 
<i>ComponentModelCorrelator</i> uses this interface to build 

discriminator vectors 

for use in the syntactic correlation process 


@author LT Steve Shedd 
@version v1.0 September 2002 


KKK KKK KKKKKKKKKKKKKK KKK KKK KKK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK */ 


public interface DiscriminatorGenerator 


{ 


[** KKK KKK KKK KK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KK KK KKK KKK 
* <br> 

Returns a list of discriminator vectors constructed from the JDOM document 
passed in as a parameter. Each element of the list is a 28 

element float array 

containing the discriminant values defined in the syntactic 

component generation 

methodology. 


@param jdom - A JDOM Document created from a well-formed XML Schema 
@return A List of discriminator vectors for the component. 

@throws JDOMException - if the jdom parameter is null or if there are any 
other JDOM problems. 


@author LT Steve Shedd 


+ + + + + F FF F F F F HF OF 


KKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEKE */ 


public List generateDiscriminatorVectors( Document jdomDoc ) throws JDOMException; 


// End DiscriminatorGenerator 
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Ze Class DiscriminatorGeneratorImpl 


J [BRK KR KKK KKK KK KK A KKK AK AA ee RRA A AAA Ae ee AK AA AA He He He 


// Filename:............. DiscriminatorGeneratorImpl. java 

// Parent PLOVSCES se snacsnsie SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

[if BURN O Ge Bese cece aia d LT Steve Shedd, USN 

Jf COMPANY siscscelacatecalecsetcs i Naval Postgraduate School, Monterey, California 

fof? WAT OE fencer ce dengnarentrcanaventuecen’ September 2002 


J [BRK KKK KK KK KKK I KKK A KA AA A RAR A AAA ee I AAA AAA AA He He He Oe 


package mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator; 


import java.util.List; 
import java.util.Iterator; 
import java.util.Vector; 
import java.util.ArrayList; 
import java.util.HashMap; 
import java.util.Set; 
import java.io.File; 

import java.io.IOException; 





import org. jdom.JDOMException; 

import org. jdom.Document; 

import org. jdom.JDOMException; 

import org. jdom.transform.JDOMSource; 
import org. jdom.input.SAXBuilder; 
import org. jdom.Element; 

import org. jdom.Attribute; 

import org. jdom.Namespace; 








[** KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KK KK kk kk KK KK KKK KK KK KKK KKK 
* <br> 

The <i>DiscriminatorGeneratorImpl</i> generates a set of discriminator 

vectors from a JDOM Document representation of a well formed XML 

Schema. The discriminator vectors are then used in the syntactic 

correlation process. 


+ + + F H F 


@author LT Steve Shedd 


* @version v1.0 September 2002 
KR KKK KKK KK KKKKKKKKKKKKKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKEKEK 


@testcase 
test.mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator.TestDiscriminatorGenera 
toriImpl 


* 


KKK KKKKKKKKKKKKK KKK KKK KK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KK KK KK KKK KK KK KKK KOK */ 
public class DiscriminatorGeneratorImpl implements DiscriminatorGenerator 


{ 


//Generator Control Variables 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK KK 


* A copy of the JDOM document created by babel to process CCR 
* and FCR XML Schemas. 


KKKKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


private Document jdomDoc = null; 


/[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KK KK KKK 
* An array list type that contains the elements of the XML schema 

in a type heirarchy. An array list was chosen over a Tree because 

of the ability to store lists within lists and benefit from 

recursion for some utitily methods. The ArrayList data type can 

also contain null values. Many other data structures 
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+ 4 + # 


could be used for this purpose, however, I decided to go with an 
array list. 


The adopted convention for using the ArrayList in 
the DiscriminatorGeneratorImpl class is as follows: 


List = { Element Name, Element Discriminator Vector [, children ] } 
or in terms of types: 
List = { String, DiscriminatorVector [, ArrayLists ] } 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
x The ordering of these elements is critical since the get method of 

* ArrayList is used extensively. The get method takes an integer index 
* as its parameter and returns the object at that index. Therefore, 

* the node type name will always be the first index, the associated 

* discriminator vector at the second index. Corresponding children 

* start in the third index and continue as needed. 

* 

* 


KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKKKEEK */ 


private ArrayList schemaTypeHierarchy = null; 


[** KKK KKK KKK KKK KKK KK KK KKK KK KK KKK KKK KK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKKKK KKK KK 
* This hash map is legend between simple data types defined in the 

* JDOM document and their constructed discriminator vector. The key 

* field of the table is name of the simple data type as specified in 

* the JDOM document. The value field is the actual discriminator vector 

* object constructed for the simple type. 

* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


private HashMap simpleTypes = null; 


[** KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* This hash map stores the qualified names of the complex types in 


* XML Schema and the associated element. 
KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK KKK KK KKK KKEKK */ 


private HashMap complexTypes = null; 


/** Root Element of the JDOM Document and XML Schema */ 
private Element docRoot = null; 


/** Namespace of the JDOM Document and XML Schema */ 
private Namespace docNamespace = null; 


/** Target namespace defined in the root element */ 
private Namespace targetNamespace = null; 


/** Default constructor */ 
public DiscriminatorGeneratorImpl () 


{ 
this.init(); 


pas 
+ 


+ + £ F FF HF 


Initialization function to reset all class variables. Since class 
scope variables are used for the discriminator generator, we need to 
reset the variables each time the constructor or 
generateDisciminatorVectors is called. In the future, class variables 
should be eliminated. 


@author LT Steve Shedd 


+ 


ay 


private void init () 
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this.jdomDoc = null; 
this.schemaTypeHierarchy = new ArrayList (); 
this.simpleTypes = new HashMap (); 
this.complexTypes = new HashMap () ; 
this.docRoot = null; 

this.docNamespace = null; 
this.targetNamespace = null; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 
* <br> 
* Returns a list of discriminator vectors constructed from the JDOM document 
passed in as a parameter. Each element of the list is a 28 
element float array 
containing the discriminant values defined in the syntactic 
component generation 
methodology. This method is the only visible work horse of the 
DiscriminatorGeneratoriImpl Class. 


@param jdom - A JDOM Document created from a well-formed XML Schema 
@return A List of discriminator vectors for the component. 

@throws JDOMException - if the jdom parameter is null or if there are any 
other JDOM problems. 


@author LT Steve Shedd 


+ + + + FF FF FF FF FH 


KKK KKK KK KK KK KK KK KKK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 
public List generateDiscriminatorVectors( Document jdom ) throws JDOMException 


{ 


if ( jdom == null ) 

{ 
throw new JDOMException( "Null pointer to JDOM Document", 
new NullPointerException() ); 


} 


// reinitialize all class variables 
this<sinit.); 


// Create a local copy of the JDOM Document 
this.jdomDoc = new Document ( jdom.getContent() ); 


// Identify root element of JDOM document and get the schema namespace 
this.docRoot = jdom.getRootElement (); 
this.docNamespace = this.docRoot.getNamespace() ; 


// Get a list of additional namespaces so that we can identify a target 
// namespaces if declared. 
List otherNamespaces = this.docRoot.getAdditionalNamespaces () ; 


terator it = otherNamespaces.iterator(); 
int count = otherNamespaces.size(); 


if ( count > 2 ) 
throw new JDOMException( "Schema contains more than one target " + 


"namespace and cannot be processed by the " + 
" Discriminator Generator." ); 


while ( it.hasNext() ) 





Namespace otherNS = ( Namespace )it.next(); 


if ( !otherNS.getPrefix().equals( this.docNamespace.getPrefix() ) ) 
{ 
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targetNamespace = otherNs; 


} 


// Get the first element under the Schema root. This is the element that 
// will define the top level sequence of data types for the entire Schema. 
Element schemaDef = this.docRoot.getChild( "element", this.docNamespace ); 


// Get the fully qualified name of the schema type 

String schemaDefName = this.makeQualifiedElementName( schemaDef.getAttributeValue ( 
"name" ) ; 

this.targetNamespace.getPrefix() ); 


// Extract the simple types and associated discriminator Vectors 
this.extractSimpleTypes (); 


// Extract the complex types and elements 
this.extractComplexTypes () ; 


this.schemaTypeHierarchy.add( 0, schemaDefName ); 
this.schemaTypeHierarchy.add( 1, new DiscriminatorVectorImpl() ); 


// Recursive function to parse through top level elements and 
// build a list hierarchy of data types. 
this.parseElement ( this.schemaTypeHierarchy, schemaDefName ); 


//Calculate the top level discriminator for the entire class if necessary 
//DiscriminatorVector topDV = (DiscriminatorVector) schemaTypeHierarchy.get (1); 


try 

{ 
// Recursively merge the vectors from the simpletype hierarchy 
this.mergeVectors( this.schemaTypeHierarchy ); 

} 

catch ( Exception e ) 

{ 
e.printStackTrace(); 


} 


//Create a list of float arrays for top level discriminator vectors 
List results = new ArrayList (); 


for ( int i = 2; i < this.schemaTypeHierarchy.size(); i++ ) 


{ 
ArrayList temp = ( ArrayList )this.schemaTypeHierarchy.get( i ); 


DiscriminatorVector result = 
new DiscriminatorVectorImpl( ( DiscriminatorVector )temp.get( 1) ); 


float[] local = result.ValuesAsFloatArray (); 
/* System.out.print( "\nRaw" + (i - 1) +": "); 


for ( int j = 0; j < local.length ; j++ ) 
{ 

System.out.print( local[j] +" " ); 
} 


System.out.print( "\n" );*/ 


try 
{ 


result.normalizeValues (); 


} 


catch ( Exception e ) 
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} 


System.out.printin( e.getMessage() ); 
e.printStackTrace(); 


} 


// Convert the singleton discriminator vector into an array of floats 
float[] values = result.ValuesAsFloatArray () ; 


// Add the float array to the final results list 
results.add( values ); 


} 
return results; 


// End generateDiscriminatorVectors 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KKK KK KKK KKK KKK KOK 


* 


4 + * + + FF HF FH F 


<br> 
Recursive function that traverese the JDOM Document and analyzes each element 
for discriminator values. 


@param parentList - a layer of the hierarchical list containing all 
the complex types. 

@param elementName - the name of the element to be analzed and parsed. 
@return None 


@author LT Steve Shedd 


KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKEKEEK */ 


private void parseElement ( ArrayList parentList, String elementName ) 


{ 


Element startNode = null; 
Element complexNode = null; 


//Get the element node with the name equal to the name in 
//the list of Complex Types 





startNode = ( Element )this.complexTypes.get( elementName ) ; 
if ( startNode == null ) 
{ 

String msg = "Unable to locate element " + elementName; 


msg = msg + " in complexTypes HashMap."; 


throw new NullPointerException( msg ); 


if ( startNode.getName().equals( "element" ) ) 


complexNode = startNode.getChild( "complexType", this.docNamespace ); 





if ( startNode.getName().equals( "complexType" ) ) 


complexNode = startNode; 





// Get the sequence node under the complex node 
Element sequenceNode = complexNode.getChild( "sequence", this.docNamespace ); 


// Get the children elements of the sequence 
List sequenceElements = sequenceNode.getChildren( "element", this.docNamespace ); 


// Build an iterator for the sequenceElement List 
Iterator sequenceIterator = sequenceElements.iterator(); 


// Step through the sequence defined in the Schema 
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while 


{ 


// 


( sequencelIterator.hasNext() ) 


Get the next element node defined in the sequence 


Element temp = ( Element )sequencelIterator.next (); 


// Create a default DiscriminatorVector that can be used for each child 


DiscriminatorVector dv = null; 
ArrayList newList = new ArrayList (); 


String typeName = null; 


if ( temp.getAttribute( "type" ) != null ) 
{ 
typeName = temp.getAttributeValue( "type" ); 
} 
else if ( temp.getAttribute( "ref" ) != null ) 


{ 


typeName = temp.getAttributeValue( "ref" ); 


newList.add( 0, typeName ); 


// 
if 
{ 


} 


Set the DiscriminatorVector for this element 
( this.simpleTypes.containsKey( typeName ) ) 


// get discriminator vector from simpleTypes hashmap 


dv = ( DiscriminatorVectorImpl )this.simpleTypes.get( typeName ); 


else 


{ 


// 
if 


// 
if 


} 


// Create a new DiscriminatorVector for a complexType 
dv = new DiscriminatorVectorImpl (); 


Check for minOccurs value 
( temp.getAttribute( "minOccurs" ) != null ) 


double val = Double.parseDouble( temp.getAttributeValue( "minOccurs" 


dv.setDVMinOccurs( val ); 
Check for maxOccurs value 
( temp.getAttribute( "maxOccurs" ) != null ) 


// Tf the maxOccurs is specified, set the corresponding 
// property in the discriminator vector. 


) 


double val = Double.parseDouble( temp. getAttributeValue( "maxOccurs" ) 


dv.setDVMaxOccurs( val ); 


else 


{ 


} 


// Add the discriminator vector to the newList created for the type 


// T£ the maxOccurs is not specified, set the property 
// to a raw value of 1. This value will be normalized. 
dv.setDVMaxOccurs( 1 ); 


newhist.add( 1, dv ); 


// 
af, 
{ 


Set the DiscriminatorVector for this element 
( !this.simpleTypes.containsKey( typeName ) ) 


// Tf this is a complexType, make a recursive call to parseElement () 


parseElement ( newList, typeName ); 
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3 


3 


// Add the child types list ("newList") to the end of the parent list. 
// This effectively creates a parent/child relationship that is 

// stored in the parent list. 

parentList.add( newList ); 


} // End parseElement 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
* <br> 

Utility method that extracts all the complex types in the JDOM 

Document and stores 

the names and objects in a hashtable. 


@param None 
@return None 


t+ * FF HF HF 


@author LT Steve Shedd 


+ 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKK */ 


protected void extractComplexTypes () 


{ 


// Build a list of complex elements from element nodes or complex type nodes. 
// This list is simple a look-up reference to help the parseElement method. 
List complexOne = this.docRoot.getChildren( "element", this.docNamespace ); 
List complexTwo = this.docRoot.getChildren( "complexType", this.docNamespace )j; 





terator complexOneIterator = complexOne.iterator(); 


while ( complexOneIterator.hasNext() ) 





Element hashKey = ( Element )complexOneIterator.next (); 


// Get the fully qualified name of the type defined in the element 
String hashValue = this.makeQualifiedElementName ( 
hashKey.getAttributeValue( "name" ), 
this.targetNamespace.getPrefix() ); 


complexTypes.put( hashValue, hashKey )j; 
} 


Iterator complexTwoIterator = complexTwo.iterator(); 


while ( complexTwolIterator.hasNext() ) 
{ 


Element hashKey = ( Element )complexTwolIterator.next (); 


// Get the fully qualified name of the type defined in the element 
String hashValue = this.makeQualifiedElementName ( 
hashKey.getAttributeValue( "name" ), this.targetNamespace.getPrefix() ); 


complexTypes.put( hashValue, hashKey ); 


} // Bnd extractComplexTypes 


/[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 
* <br> 

This function parses through the explicitly defined simpleTypes in the 

schema and builds a discriminator vector for each one. The discriminator 

vectors constructed by this function are then added to the simpleTypes 

hash map along with the name of each simple type. 


+ HF FF 


@param None 


116 


@return None 


@author LT Steve Shedd 


* 
* 
* 
* 


KKKKKK KKK KKK KKK KK KK KK KK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK */ 
protected void extractSimpleTypes () 
{ 


// Get a list of all explicitly declared elements in Schema. 
List simples = this.docRoot.getChildren( "simpleType", this.docNamespace ); 


// Get iterator for simples list 
Iterator simpleIterator = simples.iterator(); 


// iterate through the list of simple types 
while ( simplelIterator.hasNext() ) 


{ 
Element simpleNode = ( Element )simpleIterator.next (); 


// Get the fully qualified name of the type defined in the element 
String attrNameValue = this.makeQualifiedElementName ( 
simpleNode.getAttributeValue( "name" ), this.targetNamespace.getPrefix() ); 


//create a discriminator vector 
DiscriminatorVector dv = buildSimpleVector( simpleNode ); 


// Add the simple type and its discriminator vector to the simpleTypes 
// hash map. 
simpleTypes.put( attrNameValue, dv ); 


} // End extractSimpleTypes 


[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKK KKK KKK KKK KKK KK 
* <br> 

* Builds a discriminator vector for a simpleType XML element. The 
parsing of restriction elements follows the W3C specifications for 

built-in XML Schema primitive and derived data types. These specifications 
can be found at <a href="http://www.w3c.org/TR/xmlschema-2" target="_blank"> 
http: //www.w3c.org/TR/xmlschema-—2/</a>. In general, a schema must conform 
to these standards and contain 


@param simpleTypeNode - a simpleType element/node of an XML schema. 
@return A discriminator describing the simpleTypeNode 


@author LT Steve Shedd 


4+ + + + + * H + HF 


KKKKK KKK KK KKK KKK KKK KK KK KK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 
protected DiscriminatorVector buildSimpleVector( Element simpleTypeNode ) 


{ 
DiscriminatorVector result = new DiscriminatorVectorImpl (); 
// Set the property type to indicate an atomic attribute. This value 
// does not get normalized. 


result.setDVPropertyType( 1.0 ); 


//Get the name of the simpleType 
String typeName = simpleTypeNode.getAttributeValue( "name" ); 


//Get the restriction element under the simpleType element 
Element restriction = simpleTypeNode.getChild( "restriction", this.docNamespace ); 


String base = restriction.getAttributeValue( "base" ); 
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Element length = restriction.getChild( "length", docNamespace )j; 

Element minLength = restriction.getChild( "minLength", docNamespace ); 
Element maxLength = restriction.getChild( "maxLength", docNamespace ); 
Element pattern = restriction.getChild( "pattern", docNamespace ); 

List enumerations = restriction.getChildren( "enumeration", docNamespace ); 
Element minInclusive = restriction.getChild( "minInclusive", docNamespace ); 
Element maxInclusive = restriction.getChild( "maxInclusive", docNamespace ); 
Element minExclusive = restriction.getChild( "minExclusive", docNamespace ); 
Element maxExclusive = restriction.getChild( "maxExclusive", docNamespace ); 
Element totalDigits = restriction.getChild( "totalDigits", docNamespace )j; 
Element fractionDigits = restriction.getChild( "fractionDigits", docNamespace ); 





if ( base.equals( "xsd:string" ) ) 


{ 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


// 
if 
{ 


// 
it 


// 
if 


// 
VE 


// 
if 


// 


In accordance withe W3C XML Schema specification, the string primitive 


data type can have the following constraining facets: 


length 
minlength 
maxlength 
pattern 
enumeration 
whitespace 


The facet whitespace is not utilized in the discriminator vectors 


Is there a length facet? 
( length != null ) 


// If yes, then set the min and max length properties 
// to the value of the length element 


double temp = Double.parseDouble( length.getAttributeValue( "value" ) 


result.setDVMinLength( temp ); 
result.setDVMaxLength( temp ); 


Is there a minLength facet? 
( minLength != null ) 


// Tf yes, set the minLength restriction 
double temp = Double.parseDouble( minLength.getAttributeValue ( 
result.setDVMinLength( temp ); 


Is there a maxLength facet? 
( maxLength != null ) 


// Tf yes, set the maxLength restriction 
double temp = Double.parseDouble( maxLength.getAttributeValue ( 
result.setDVMaxLength( temp ); 


Is there a defined pattern facet? 

( pattern != null ) 

// Tf yes, set the pattern property to 1.0 
result.setDVPattern( 1.0 ); 

Are there enumeration facets? 

( lenumerations.isEmpty() ) 


// Tf yes, get the number of enumerations and put in vector 
result.setDVNumEnumerations( ( double )enumerations.size() ); 


"value" 


"value" 


Lastly, set the data type proporty to 1.0 to denote the data type 
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) 


) 


i 


i 


result.setDVStringType( 1.0 ); 


} 


else if ( base.equals( "xsd:boolean" ) ) 


{ 


// 
// 
// 
// 
// 
// 
// 


// 
it 
{ 
} 


// 


In accordance withe W3C XML Schema specification, the boolean primitive 
data type can have the following constraining facets: 


pattern 
whitespace 


The facet whitespace is not utilized in the discriminator vectors 


Is there a defined pattern facet? 
( pattern != null 


// Tf yes, set the pattern property to 1.0 
result.setDVPattern( 1.0 ); 





Lastly, set the data type property to 1.0 to denote the data type 


result.setDVBooleanType( 1.0 ); 


} 


else if ( base.equals( "xsd:float" ) || base.equals( "xsd:double" ) 


{ 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


// 
it 
{ 


// 
if 


// 
if 


hd: 
if 


In accordance withe W3C XML Schema specification, the float and 
double primitive data types can have the following constraining facets: 


pattern 
enumeration 
whitespace 
minInclusive 
maxInclusive 
minExclusive 
maxExclusive 


The facet whitespace is not utilized in the discriminator vectors 
Is there a defined pattern facet? 

( pattern != null 

// Tf yes, set the pattern property to 1.0 
result.setDVPattern( 1.0 ); 

Are there enumeration facets? 

( !enumerations.isEmpty() ) 

// Tf yes, get the number of enumerations and put in vector 
result.setDVNumEnumerations( ( double )enumerations.size() ); 
Is there a minInclusive facet? 

( minInclusive != null ) 

// Tf yes, set the minInclusive restriction 


double temp = Double.parseDouble (minInclusive.getAttributeValue ("value") ); 
result.setDVMinInclusive( temp ); 


Is there a maxInclusive facet? 
( maxInclusive != null ) 


// Tf yes, set the maxInclusive restriction 
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// 
if 


// 
if 


} 

// 
if 
if 


} 


double temp = Double.parseDouble (maxInclusive.getAttributeValue ("value") ); 
result.setDVMaxInclusive( temp ); 


Is there a minExclusive facet? 
( minExclusive != null ) 


// Tf yes, set the minExclusive restriction 
double temp = Double.parseDouble (minExclusive.getAttributeValue ("value") ); 
result.setDVMinExclusive( temp ); 


Is there a maxExclusive facet? 
( maxExclusive != null ) 


// Tf yes, set the maxExclusive restriction 
double temp = Double.parseDouble (maxExclusive.getAttributeValue ("value") ); 
result .setDVMaxExclusive( temp ); 


Lastly, set the data type property to 1.0 to denote the data type 
( base.equals( "xsd:float" ) ) { result.setDVFloatType( 1.0 ); } 
( base.equals( "xsd:double" ) ) { result.setDVDoubleType( 1.0 ); } 


else if ( base.equals( "xsd:BigDecimal" ) || base.equals( "xsd:integer" ) | 
base.equals( "xsd:long" ) || base.equals( "xsd:short" ) ) 


{ 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


// 
if 
{ 


// 
if 


// 


if 


// 


In accordance withe W3C XML Schema specification, the decimal 
primitive data type can have the following constraining facets: 


totalDigits 
fractionDigits 
pattern 
enumeration 
whitespace 
minInclusive 
maxInclusive 
minExclusive 
maxExclusive 


The facet whitespace is not utilized in the discriminator vectors 


Is there a totalDigits facet? 
( totalDigits != null ) 


// If yes, set the total digits property 
double temp = Double.parseDouble(totalDigits.getAttributeValue("value" )); 
result.setDVTotalDigits( temp ); 


Is there a fractionDigits facet? 
( fractionDigits != null ) 


// If yes, set the fraction digits property 
double temp = Double.parseDouble(fractionDigits.getAttributeValue ("value") ); 
result.setDVFractionDigits( temp ); 








Is there a defined pattern facet? 
( pattern != null ) 


// Tf yes, set the pattern property to 1.0 
result.setDVPattern( 1.0 ); 


Are there enumeration facets? 
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} 


if ( !enumerations.isEmpty() ) 


// If yes, get the number of enumerations and put in vector 
result.setDVNumEnumerations( ( double )enumerations.size() ); 


// Is there a minInclusive facet? 
if ( minInclusive != null ) 


// If yes, set the minInclusive restriction 
double temp = Double.parseDouble (minInclusive.getAttributeValue ("value") ); 
result.setDVMinInclusive( temp ); 


// Is there a maxInclusive facet? 
if ( maxInclusive != null ) 


// Tf yes, set the maxInclusive restriction 
double temp = Double.parseDouble (maxInclusive.getAttributeValue ("value") ); 
result.setDVMaxInclusive( temp ); 


// Is there a minExclusive facet? 
if ( minExclusive != null ) 


// Tf yes, set the minExclusive restriction 
double temp = Double.parseDouble (minExclusive.getAttributeValue ("value") ); 
result.setDVMinExclusive( temp ); 


// Is there a maxExclusive facet? 
if ( maxExclusive != null ) 


// Tf yes, set the maxExclusive restriction 
double temp = Double.parseDouble (maxExclusive.getAttributeValue ("value") ); 
result .setDVMaxExclusive( temp ); 


// Set the data type property to 1.0 to denote the data type 
if ( base.equals( "xsd:BigDecimal" ) 
) { result.setDVBigDecimalType( 1.0 ); } 


if ( base.equals( "xsd:integer" ) ) { result.setDVIntType( 1.0 ); } 
if ( base.equals( "xsd:long" ) ) { result.setDVLongType( 1.0 ); } 
if ( base.equals( "xsd:short" ) ) { result.setDVShortType( 1.0 ); } 
} 
else 


{ 
// Lastly, set the data type property to 1.0 to denote the data type 
result.setDVOtherType( 1.0 ); 


return result; 


// End buildSimpleVector 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* 


+e + + FF + *F 


<br> 

Recursive function to merge the discriminator vectors of the child data types 
with the vectors of the parent types. The merge method 

traverses the ArrayList 

passed in as param 1 and modifies the values of the 

discriminator vector passed 

by reference as param 2. (i.e) index 0 must be the name of data type, index 1 
must be the data types discriminator vector, and index 2 begins the 

children associated with the data type. 
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@param parentList - An ArrayList conforming to the correlator schema. 
@return None 


@author LT Steve Shedd 


KKKKKKK KKK KKK KKK KKK KKK KK KK KK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public void mergeVectors( ArrayList parentList ) throws Exception 
{ 


int parentListSize = parentList.size(); 
DiscriminatorVector parentDV = ( DiscriminatorVector )parentList.get( 1 ); 


if ( parentListSize > 2 ) 


{ 


for ( int z = 2; z < parentListSize; zt++ ) 


{ 
ArrayList nextChildList = ( ArrayList )parentList.get( z ); 
// Make recursive calls to the mergeVector routine. 
// As shown in the second parameter, it is crucial that the 
// discriminator vector be stored in the 2nd index of the list 
// which is index 1 in a O0-based indexing scheme. 
mergeVectors( nextChildList ); 
DiscriminatorVector childDV = (DiscriminatorVector) nextChildList.get (1); 
/* 
System.out.print ("\nMerging " + nextChildList.get(0) + 
" with parent " + parentList.get(0) + " after recursion:"); 
float[] child = childDV.getValuesAsFloatArray (); 
System.out.print ("\nchild: \t"); 
for ( int i= 0; i < child.length ; i++ ) { 


System.out.print( child[i] + " "); 


float[] parent = parentDV.getValuesAsFloatArray (); 

System.out.print ("\nparent:\t"); 

for ( int j = 0; j < parent.length ; jt+ ) { 
System.out.print( parent[j] + " "); 

} 

x] 

parentDV.mergeChildWithParent ( childDV ); 

/* 

float[] after = parentDV.getValuesAsFloatArray (); 


System.out.print ("\nresult:\t"); 





for ( int k = 0; k < after.length ; k++ ) { 


System.out.print( after[k] + " "); 





mf 
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} // End mergeVectors 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 
* <br> 

Small utility method to generate a fully qualified name of schema type. The 

method simply concatenates the target namespace of the schema to the front of 
the schema data type. 


@param elementName - The name of the data type 
@param targetNamespace - The name of the targetNamespace 
@return The qualified name of the schema type 


@author LT Steve Shedd 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK EK */ 


private String makeQualifiedElementName( String elementName, 
String targetNamespace ) 


{ 


return targetNamespace + ":" + elementName; 
} 
} // End DiscriminatorGenerator 
3. Interface DiscriminatorVector 

J [BRR RR RR KK KK KK I A IKARIA KR A RA AAA A A A KK AAA A AA A He He He 
// Filename:............. DiscriminatorVector. java 
// Parent PYOJSC US 2 eee ater SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 
// Original Compiler:....Sun JDK 1.3.1_04 
fs. BUENO Bis Picasso steraiest: & LT Steve Shedd, USN 
ff COMPADY. 22. Sie Aa ee a Naval Postgraduate School, Monterey, California 
//- Date. 34 te2 4a eee tee ees September 2002 


J [RRR KK KR KK KKK KKK KA KAA A ee RRR A A A IAA AA A A AAA A I I I 


package mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator; 


import java.lang.Exception; 


[** 

* The <i>DiscriminatorVector</i> interface defines the services required 

* for an implementation of a discriminator vector class. The discriminator 
* vector includes the logic for normalization and conversion to other data 
* types. 

* 

* @author LT Steve Shedd 

* @version 1.0 September, 2002 

* 

* 


/ 
public interface DiscriminatorVector 


{ 


igs 
t+ * te HF 
x 


Leg 


Normalizes the current raw values of the vector in 
accrodance with the speicific normalization routine 
defined. 


@throws Exception if there is a math error in the normalization routine 
@author LT Steve Shedd 
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public void normalizeValues() throws Exception; 


[** 
* @return the discriminator vector as an array of doubles 
* @author LT Steve Shedd 
*/ 

public double[] ValuesAsDoubleArray (); 


[** 

* @return the discriminator vector as an array of floats 
* @author LT Steve Shedd 
xh 

public float[] ValuesAsFloatArray(); 


ee, 
+ 


+ * + FF * OF 


Utility function that combines two discriminator vectors in 
accordance with predefined rules. 


@param in - A discriminator vector to merge with the current vector 
@return None 

@author LT Steve Shedd 

ia 


public void mergeChildWithParent ( DiscriminatorVector in ) throws Exception; 


[** 
* @return true if the vector describes an attribute, false otherwise. 
* @author LT Steve Shedd 

*/ 

public boolean isAttribute(); 


[** 

* @return true if the vector is a complex attribute, false otherwise. 
* @author LT Steve Shedd 

*/ 


public boolean isComplex(); 


/[** 

* @return true if the vector is normalized, false otherwise. 
* @author LT Steve Shedd 

*/ 


public boolean isNormalized(); 


[** 

* @return true if the vector describes an operation, false otherwise. 
* @author LT Steve Shedd 

*/ 


public boolean isOperation(); 


[** 
* The get and set methods that follow are for discriminate properties 
* used in the discriminator vector. 


* @author Steve Shedd 


public double getDVPropertyType(); 
public double getDVIsComplex(); 
public double getDVNumSubTypes () ; 
public double getDVNumReqdSubTypes ( 
public double getDVNumOptSubTypes () 
public double getDVNumOperations(); 
public double getDVNumParameters (); 
public double getDVStringType(); 
public double getDVBooleanType () ; 
public double getDVFloatType(); 
public double getDVDoubleType() ; 
public double getDVBigDecimalType() ; 
public double getDVIntType(); 


3 


, 











0000000 
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public double getDVLongType() ; 
public double getDVShortType () 
public double getDVOtherType(); 
public double getDVMinOccurs(); 
() 
() 


, 


, 


public double getDVMaxOccurs 
public double getDVMinLength 
public double getDVMaxLength (); 
public double getDVTotalDigits(); 
public double getDVFractionDigits(); 
public double getDVPattern (); 

public double getDVNumEnumerations(); 
public double getDVMinExclusive(); 
public double getDVMaxExclusive(); 
public double getDVMinInclusive(); 
public double getDVMaxInclusive () 


, 





’ 


public void setDVPropertyType( double value ); 
public void setDVIsComplex( double value ); 
public void setDVNumSubTypes( double value ); 
public void setDVNumReqdSubTypes( double value ); 
public void setDVNumOptSubTypes( double value ); 
public void setDVNumOperations( double value ); 
public void setDVNumParameters( double value ); 
public void setDVStringType( double value ); 
public void setDVBooleanType( double value ); 
public void setDVFloatType( double value ); 
public void setDVDoubleType( double value ); 
public void setDVBigDecimalType( double value ); 
public void setDVIntType( double value ); 
public void setDVLongType( double value ); 
public void setDVShortType( double value ) 
public void setDVOtherType( double value ); 
public void setDVMinOccurs( double value ); 
( ) 
( ) 











, 


, 


public void setDVMaxOccurs( double value 
public void setDVMinLength( double value 
public void setDVMaxLength( double value ); 
public void setDVTotalDigits( double value ); 
public void setDVFractionDigits( double value ); 
public void setDVPattern( double value ); 

public void setDVNumEnumerations( double value ); 
public void setDVMinExclusive( double value ); 
public void setDVMaxExclusive( double value ); 
public void setDVMinInclusive( double value ); 
public void setDVMaxInclusive( double value ) 


, 





, 





} // End DiscriminatorVector 


// 
// 
// 
// 
// 
// 


4. Class Discriminator VectorImpl 
J [BRR KKK KKK KK KK KK A ee KKK AAAI A ee AAA RAR A A A ee AAA A A A A He He He oe 
Ba Lename’scceve Greens os DiscriminatorVectorImpl. java 
Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 
Original Compiler:....Sun JDK 1.3.1_04 
AUCHORS wai Se elie s es LT Steve Shedd, USN 
COMDaTTY £5 sash asa e Haus Naval Postgraduate School, Monterey, California 
Da Sei ood eee sae sorts Sige uene oe September 2002 


// 


J [BR RRR KK KKK KK KK A KKK I I KAA AA AA A A A AAA AA A A A AA AA A He He He oe 


package mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator; 


import java.util.Map; 
import java.util.HashMap; 
import java.util.Set; 
import java.util.Iterator; 


import java.lang.Double; 
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import java.lang.Math; 


import java.io.IOException; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK kk KK KK KK KK KK KK KKK KK 


The <i>DiscriminatorVectorImpl</i> class stores the values of a 
discriminator vector. It includes the logic for normalization and 
conversion of the vectore to other data types. The class is not used outside 
of the syntacticComponentGeneration module. 


@author LT Steve Shedd 
@version 1.0 September, 2002 


+ + + % FH FH 


KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK */ 


public class DiscriminatorVectorImpl implements DiscriminatorVector 


{ 


[** KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
* Data structure that holds the enumeration of the discrimintor vector 

* elements and the values of those elements. This data type was chosen 

* becuase of its inherent ability to store a key and value. In this case 

* the key is a string representing the element label and the value is the 
* 
* 


actual value of the element represented as a double 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK EK */ 


private HashMap dv = null; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKK KKK KKK KKK KKK KK KKK KKK KK KKK KK KKK KKK KOK 


* Data structure that holds a backup copy of the discriminator vector. The 


* purpose of this class attribute is for a future undo feature if desired. 
KKKK KKK KKK KK KKK KK KK KKK KK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


private HashMap backup = null; 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Boolean control variable to test whether the data contained in the 


* discriminator vector has been normalized or not. 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KK KK KK */ 


private boolean isNormalized = false; 


/** Boolean to track whether the vector is for an operation or not. */ 
private boolean isOperation = false; 


/** Boolean to track whether the vector is a complex type or not. */ 
private boolean isComplex = false; 





/** Boolean to track whether the vector is an atomic attribute or not. */ 
private boolean isAttribute = true; 





/** Default no-arg constructor. */ 
public DiscriminatorVectorImpl () 


{ 


initVector (); 


/[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Copy constructor. This constructor initializes a descriminator 
vector hash map with the values of another disciminator vector 
passed in as an argument. 


@author LT Steve Shedd 
@param A discriminator vector from which another vector will be created. 
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4 * * F 


* 


KKK KK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


public DiscriminatorVectorImpl( DiscriminatorVector in ) 


{ 
initVector(); 


// Set local control booleans 
this.isOperation = in.isOperation () 
this.isAttribute = in.isAttribute() 
this.isComplex = in.isComplex (); 
this.isNormalized = in.isNormalized(); 


’ 
’ 


his.setDVPropertyType( in.getDVPropertyType() ); 
his.setDVIsComplex( in.getDVIsComplex() ); 
his.setDVNumSubTypes( in.getDVNumSubTypes() ); 
his.setDVNumReqdSubTypes( in.getDVNumReqdSubTypes() ); 
his.setDVNumOpt SubTypes( in.getDVNumOptSubTypes() ); 
his.setDVNumOperations( in.getDVNumOperations() ) 
his.setDVNumParameters( in.getDVNumParameters() ) 
his.setDVStringType( in.getDVStringType() ); 
his.setDVBooleanType( in.getDVBooleanType() ); 
his.setDVFloatType( in.getDVFloatType() ); 
his.setDVDoubleType( in.getDVDoubleType() ); 
his.setDVBigDecimalType( in.getDVBigDecimalType() ); 
his.setDVIntType( in.getDVIntType() ); 
his.setDVLongType( in.getDVLongType () 
his.setDVShortType( in.getDVShortType ( 
his.setDVOtherType( in.getDVOtherType ( 
his.setDVMinOccurs( in.getDVMinOccurs ( 
( ( 
( ( 


’ 
, 





tata ttteattete at tae tae 


Ch chr. 


his.setDVMaxOccurs( in.getDVMaxOccurs 
his.setDVMinLength( in.getDVMinLength 
his.setDVMaxLength( in.getDVMaxLength() ); 
his.setDVTotalDigits( in.getDVTotalDigits() ); 
his.setDVFractionDigits( in.getDVFractionDigits() ); 
his.setDVPattern( in.getDVPattern() ); 
his.setDVNumEnumerations( in.getDVNumEnumerations() ); 
his.setDVMinExclusive( in.getDVMinExclusive() ); 
his.setDVMaxExclusive( in.getDVMaxExclusive () ; 
his.setDVMinInclusive( in.getDVMinInclusive() ); 
his.setDVMaxInclusive( in.getDVMaxInclusive() ); 


i 
) 
) 
) 
) 
) 





atactca 























Gh ch chet ch che Gk Cech crc 


this.backup = new HashMap( this.dv ); 


} // End copy constructor 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKKKKK KKK KK KKK KKK KKK 


* Private utility method to initialize discriminator vector. Called from 
within the constructors. 


* 

* 

* @param None 
* @return None 
* 
* 
* 
* 


@author LT Steve Shedd 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK */ 


private void initVector() 


{ 


// Create a new hash map with a capacity of 28 elements 
dv = new HashMap( 28 ); 


// Initialize the hash map with a place holder foreach element 

// of a discriminator vector. 

dv.put( "propertyType", new Double( 1.0) ); // vector property 1 
( "isComplex", new Double( 0.0 ) ); // vector property 2 

dv.put( "numSubTypes", new Double( 0.0 ) ); // vector property 3 
( "numReqdSubTypes", new Double( 0.0 ) ); // vector property 4 
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dv.put( "numOptSubTypes", new Double( 0.0 ) ); // vector property 5 

dv.put( "numOperations", new Double( 0.0 ) ); // vector property 6 

dv.put( "numParameters", new Double( 0.0 ) ); // vector property 7 

dv.put( "stringType", new Double( 0.0 ) ); // vector property 8 

dv.put ( "booleanType", new Double( 0.0 ) ); // vector property 9 

dv.put( "floatType", new Double( 0.0 ) ); // vector property 10 
dv.put( "doubleType", new Double( 0.0 ) ); // vector property 11 
dv.put( "bigDecimalType", new Double( 0.0 ) ); // vector property 12 
dv.put( "intType", new Double( 0.0 ) ); // vector property 13 
dv.put( "longType", new Double( 0.0 ) ); // vector property 14 
dv.put( "shortType", new Double( 0.0 ) ); // vector property 15 
dv.put( "otherType", new Double( 0.0 ) ); // vector property 16 
dv.put( "minOccurs", new Double( 0.0 ) ); // vector property 17 
dv.put( "maxOccurs", new Double( 0.0 ) ); // vector property 18 
dv.put( "minLength", new Double( 0.0 ) ); // vector property 19 
dv.put( "maxLength", new Double( 0.0 ) ); // vector property 20 
dv.put( "totalDigits", new Double( 0.0 ) ); // vector property 21 
dv.put( "fractionDigits", new Double( 0.0 ) ); // vector property 22 
dv.put( "pattern", new Double( 0.0 ) ); // vector property 23 
dv.put( "numEnumerations", new Double( 0.0 ) ); // vector property 24 
dv.put ( "minExclusive", new Double( 0.0 ) ); // vector property 25 
dv.put ( "maxExclusive", new Double( 0.0 ) ); // vector property 26 
dv.put ( "minInclusive", new Double( 0.0 ) ); // vector property 27 
dv.put ( "maxInclusive", new Double( 0.0 ) ); // vector property 28 

} // End initVector () 


LITLTSTTLTITST LITA T TTT TIT TTT TAT TTT TTT LTITTATTTD ATT TTAT TTT T TTT T TTA TT TT 
// // 


// Vector Normalization Section // 


// // 
SITLLLTSTST LTT TI TST ELT T TST TITTIES 


[** KKK KKK KKK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KKK KKK KKK KK KKK KKKK KKK KKK 
* The major utility function of the DiscriminatorVector class. This function 
takes an instance of a DiscriminatorVector and normalizes each value of each 

element in accrodance with the OOMI correlation normalization schemes. 


The neural network used for the correlation process requires each value of 
an element to be in the range [0.0,1.0]. 


x @author LT Steve Shedd 
a @return A normalized instance of the DiscriminatorVector with 


+ element values in the range [0.0,1.0] 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KK KKK */ 


public void normalizeValues() throws Exception 


{ 
if ( this.isNormalized() ) 


throw new Exception( "Cannot normalize a vector that has already" + 
"already been normalized." ); 


else 





// create a backup copy of the hashmap. This feature is included for a possible 
// undo feature if desired in the futre. 
this.backup = new HashMap( this.dv ); 


// Set local control booleans 
boolean operation = getDVPropertyType() == 0.0 ? true : false; 
boolean attribute = getDVPropertyType() == 1.0 ? true : false; 
boolean complex = getDVIsComplex() == 1.0 ? true : false; 





// Normalize each value of the discriminator vector. 
Lf 


// We do not normalize the following properties: 
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// propertyType 
// isComplex 
// minOccurs 


if ( complex ) 


setDVNumSubTypes( normalizeTwo( getDVNumSubTypes() ) ); 
setDVNumReqdSubTypes ( normalizeTwo( getDVNumReqdSubTypes() ) ); 
setDVNumOpt SubTypes ( normalizeTwo( getDVNumOptSubTypes() ) ); 
setDVNumOperations( normalizeTwo( getDVNumOperations() ) ); 
setDVPattern( normalizeTwo( getDVPattern() ) ); 


if ( complex || operation ) 


setDVNumParameters( normalizeTwo( getDVNumParameters() ) ); 
setDVStringType( normalizeTwo( getDVStringType() ) ); 
setDVBooleanType( normalizeTwo( getDVBooleanType() ) ); 
setDVFloatType( normalizeTwo( getDVFloatType() ) ); 
setDVDoubleType( normalizeTwo( getDVDoubleType() ) ); 
setDVBigDecimalType( normalizeTwo( getDVBigDecimalType() ) ); 
setDVIntType( normalizeTwo( getDVIntType() ) ); 
setDVLongType( normalizeTwo( getDVLongType() ) ); 
setDVShortType( normalizeTwo( getDVShortType() ) ); 
setDVOtherType( normalizeTwo( getDVOtherType() ) ); 











if ( !operation ) 

{ 
setDVMaxOccurs( normalizeTwo( getDVMaxOccurs() ) ); 
setDVMinLength( normalizeTwo( getDVMinLength() ) ); 
setDVMaxLength( normalizeThree( getDVMaxLength() ) ); 
setDVTotalDigits( normalizeThree( getDVTotalDigits() ) ); 
//if ( this.getDVFractionDigits() == 0.0) { 
this.setDVFractionDigits( 0.0 ); 
//} 
//else { 
// this.setDVFractionDigits( normalizeThree( getDVFractionDigits() ) ); 
//} 
if ( this.getDVNumEnumerations() == 0.0 ) 





{ 


this.setDVNumEnumerations( 0.0 ); 


} 


else 
{ 
this.setDVNumEnumerations( normalizeTwo( getDVNumEnumerations() ) ); 

} 

setDVMinExclusive( normalizeThree( getDVMinExclusive() ) ); 
setDVMaxExclusive( normalizeThree( getDVMaxExclusive() ) ); 
setDVMinInclusive( normalizeThree( getDVMinInclusive() ) ); 
setDVMaxInclusive( normalizeThree( getDVMaxInclusive() ) ); 


} 


// Set the normalized boolean to true. 
this.isNormalized = true; 


} // End normalizeValues 


[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKK KKK 


* The first noralization function defined in the methodology. 
* 
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@param x - a double value to be normalized 
@return the normalization of the input 


@author LT Steve Shedd 


* 
* 
* 
* 
* 
* 


KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KEKE */ 


protected double normalizeOne( double x ) 
{ 

double k = 1.01; 

return 1 / (1 + Math.pow( k, -x ) ); 


/** The reverse normalization of normOne if ever needed */ 
protected int reverseNormOne( double y ) 
{ 
double k = 1.01; 
Double x = new Double( Math.log( y / (1- y) ) / Math.log( k ) ); 
int result = x.intValue(); 
return result; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK 


* The second noralization function defined in the methodology 


@param x - a double value to be normalized 
@return the normalization of the input 


tH HF 


@author LT Steve Shedd 


* 
KKK K KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKKK KK KK */ 
protected double normalizeTwo( double x ) 
{ 
double k = 1.01; 
return 2 * (1 / (1 + Math.pow( k, -x ) ) ) - 0.5; 


/[** KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKKKKKKKKKKKKK 


* The third noralization functions defined in the methodology 


@param x - a double value to be normalized 
@return the normalization of the input 


x * tt 


@author LT Steve Shedd 


* 
KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKKK KK */ 
protected double normalizeThree( double x ) 
{ 
return ( Math.log( x + 1) / Math.log( 10 ) ) / 5; 
} 


LITLTSTELTLITST LITTLE TLT TTT TTT TTT ATTA TTT TTT TTT ATTA TTT TT 
// / 


// Discriminator Element Get/Set Methods Section // 
// // 
JILILITTLTTTT ATLA T ATTA TTA TAT TATA TATA TATA TATA TATA TTA ATA 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Get the value of the private member variable isOperation. 


@return Return true if the discriminator vector describes an 
operation, false otherwise. 


4 + * ¥ 


@author LT Steve Shedd 
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KKKKK KKK KKK KKK KKK KK KK KK KK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public boolean isOperation() 
{ 
return getDVPropertyType() == 0.0 ? true : false; 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


Get the value of the private member variable isComplex. 


@return Return true if the discriminator vector describes a 
complex attribute/type, false otherwise. 


@author LT Steve Shedd 


+t H+ * HK 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KEKE KEK */ 
public boolean isComplex () 


{ 
return getDVIsComplex() == 1.0 ? true : false; 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Get the value of the private member variable isAttribute. 


@return Return true if the discriminator vector describes an 
atomic attribute, false otherwise. 


@author LT Steve Shedd 


+ + * FF F 


KKK KKK KKK KKK KKK KK KKK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public boolean isAttribute() 


{ 
return getDVPropertyType() == 1.0 ? true : false; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KK KK KKK KKK 


* Get the value of the private member variable isNormalized. 


@return Return true if the values of the discriminator vector have 
been normalized to double in the range [0.0, 1.0], false otherwise. 


@author LT Steve Shedd 


+ x FF HF 


KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKEK */ 


public boolean isNormalized() 
{ 


return this.isNormalized; 


[ [RRRRK Discriminate #1 petite ay 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element property type 
@return The value of the proporty type element of the discriminator vector 


@author LT Steve Shedd 


4 FF 


KKK KKK KK KK KK KKK KK KK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK */ 


public double getDVPropertyType () 
{ 


Double value = ( Double )dv.get( "propertyType" ); 
return value.doubleValue (); 
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/** Set the value of the discriminator vector element property type */ 
public void setDVPropertyType( double value ) 
{ 

this.dv.put( "propertyType", new Double( value ) ); 


if ( value == 1.0 ) 


this.isAttribute = true; 
this.isOperation = false; 


else 


this.isAttribute = false; 
this.isOperation = true; 





[ [RRRRK Discriminate #2 REAEK f/: 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Get the value of the discriminator vector element isComplex 
@return The value of the isComplex element of the discriminator vector 


@author LT Steve Shedd 


te * HF 


KKKKK KKK KK KK KKK KK KK KK KK KK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK */ 


public double getDVIsComplex () 

{ 
Double value = ( Double )dv.get( "isComplex" ); 
return value.doubleValue (); 


/** Set the value of the discriminator vector element isComplex */ 
public void setDVIsComplex( double value ) 
{ 


this.dv.put( "isComplex", new Double( value ) ); 


if ( value == 1.0 ) 
{ 

this.isComplex = true; 
} 


else 


{ 





this.isComplex = false; 


} 


[ [RK RK Discriminate #3 RRARKRAT 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Get the value of the discriminator vector element numSubTypes 
@return The value of the numSubTypes element of the discriminator vector 


@author LT Steve Shedd 


+ * HF 


KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 
public double getDVNumSubTypes () 


{ 
Double value = ( Double )dv.get( "numSubTypes" ); 
return value.doubleValue(); 
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/** Set the value of the discriminator vector element numSubTypes */ 
public void setDVNumSubTypes( double value ) 


{ 
this.dv.put( "numSubTypes", new Double( value ) ); 


[ [RRRRK Discriminate #4 ARR, [/- 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 


* Get the value of the discriminator vector element numReqdSubTypes 
* 


* @return The value of the numReqdSubTypes element of the discriminator vector 
* 


* @author LT Steve Shedd 
* 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKEKEKK */ 
public double getDVNumReqdSubTypes () 
{ 
Double value = ( Double )dv.get( "numReqdSubTypes" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element numReqdSubTypes */ 
public void setDVNumReqdSubTypes( double value ) 
{ 

this.dv.put( "numReqdSubTypes", new Double( value ) ); 


[ [RRRRK Discriminate #5 KKK / / 


[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element numOptSubTypes 
* 


* @return The value of the numOptSubTypes element of the discriminator vector 
* 


* @author LT Steve Shedd 


* 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKK */ 
public double getDVNumOptSubTypes () 


{ 
Double value = ( Double )dv.get( "numOptSubTypes" ); 
return value.doubleValue (); 


/** Set the value of the discriminator vector element numOptSubTypes */ 
public void setDVNumOptSubTypes( double value ) 


{ 
this.dv.put( "numOptSubTypes", new Double( value ) ); 


} 


[ [RRRRK Discriminate #6 cscs ie 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Get the value of the discriminator vector element numOperations 
* 


* @return The value of the numOperations element of the discriminator vector 
* 


* @author LT Steve Shedd 


* 
KKKKKKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


public double getDVNumOperations () 
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Double value = ( Double )dv.get( "numOperations" ); 
return value.doubleValue (); 


/** Set the value of the discriminator vector element numOperations */ 
public void setDVNumOperations( double value ) 


{ 


this.dv.put( "numOperations", new Double( value ) ); 


[ [RRRRK Discriminate #7 a sa 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKK KKK KKK KKK KKK KK 


* Get the value of the discriminator vector element numParameters 
* 


* @return The value of the numParameters element of the discriminator vector 
* 


* @author LT Steve Shedd 


* 
KKKKKKKK KKK KKK KKK KK KKK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK */ 


public double getDVNumParameters () 
{ 


Double value = ( Double )dv.get( "numParameters" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element numParameters */ 
public void setDVNumParameters( double value ) 


{ 


this.dv.put( "numParameters", new Double( value ) ); 


[ [RRRRK Discriminate #8 Sete af 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Get the value of the discriminator vector element stringType 
* @return The value of the stringType element of the discriminator vector 


* @author LT Steve Shedd 


* 


KKKKK KKK KKK KKK KKK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 


public double getDVStringType () 

{ 
Double value = ( Double )dv.get( "stringType" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element stringType */ 
public void setDVStringType( double value ) 
{ 

this.dv.put( "stringType", new Double( value ) ); 


[ [RRRRK Discriminate #9 ARR] 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element booleanType 


@return The value of the booleanType element of the discriminator vector 


4 + # 
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* @author LT Steve Shedd 


* 
KKKKKK KKK KKK KKK KK KK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKK KKK KKK KK KKK KK KKK */ 
public double getDVBooleanType () 


{ 
Double value = ( Double )dv.get( "booleanType" ); 


return value.doubleValue(); 


/** Set the value of the discriminator vector element booleanType */ 
public void setDVBooleanType( double value ) 


{ 
this.dv.put( "booleanType", new Double( value ) ); 


} 


[ [RRRKK Discriminate #10 RARE EL 


/[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KK 


* Get the value of the discriminator vector element floatType 
* 


* @return The value of the floatType element of the discriminator vector 


* @author LT Steve Shedd 


* 
KKK KKK KKK KKK KK KKK KK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 
public double getDVFloatType () 


{ 
Double value = ( Double )dv.get( "floatType" ); 


return value.doubleValue(); 


/** Set the value of the discriminator vector element floatType */ 
public void setDVFloatType( double value ) 


{ 
this.dv.put( "floatType", new Double( value ) ); 
} 


[[RRRRR Discriminate #11 KEKE | / 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element doubleType 
* 


* @return The value of the doubleType element of the discriminator vector 
* 


* @author LT Steve Shedd 


* 
KKKKKKK KKK KK KKK KK KK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 
public double getDVDoubleType () 
{ 
Double value = ( Double )dv.get( "doubleType" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element doubleType */ 
public void setDVDoubleType( double value ) 
{ 
this.dv.put( "doubleType", new Double( value ) ); 
} 


[[RRRKRR Discriminate #12 RRKKK f | 


[** KKEKKKKK KK KK KKK KK KKK KKK KK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKK KK KKK 
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* Get the value of the discriminator vector element bigDecimalType 

* 

* @return The value of the bigDecimalType element of the discriminator vector 
* 

* 


@author LT Steve Shedd 


KKKK KKK KKK KK KK KK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK */ 


public double getDVBigDecimalType () 

{ 
Double value = ( Double )dv.get( "bigDecimalType" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element bigDecimalType */ 
public void setDVBigDecimalType( double value ) 
{ 

this.dv.put( "bigDecimalType", new Double( value ) ); 


[ [RRRKK Discriminate #13 Saray 


/[** KKK KK KK KKK KK KK KK KK ee 


* Get the value of the discriminator vector element intType 
@return The value of the intType element of the discriminator vector 


@author LT Steve Shedd 


+ + # OF 


KREKKKKKKKKKKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKK */ 


public double getDVIntType () 

{ 
Double value = ( Double )dv.get( "intType" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element intType */ 
public void setDVIntType( double value ) 
{ 

this.dv.put( "intType", new Double( value ) ); 


[[RRRKX Discriminate #14 KRKKK / / 


[** KKK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKK KK KKK KKKKKKKKKKKKKKEK 


* Get the value of the discriminator vector element longType 


@return The value of the longType element of the discriminator vector 


@author LT Steve Shedd 


+ + * HF 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 
public double getDVLongType () 
{ 
Double value = ( Double )dv.get( "longType" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element longType */ 
public void setDVLongType( double value ) 
{ 


this.dv.put( "longType", new Double( value ) ); 
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[ [RRR KK Discriminate #15 RARE ELT. 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK 


* Get the value of the discriminator vector element shortType 
@return The value of the shortType element of the discriminator vector 


*. 
* 
* @author LT Steve Shedd 
* 


KKKKK KKK KKK KKK KK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public double getDVShortType () 

{ 
Double value = ( Double )dv.get( "shortType" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element shortType */ 
public void setDVShortType( double value ) 
{ 
this.dv.put( "shortType", new Double( value ) ); 
} 


[ [RRRRK Discriminate #16 RRR ff 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element otherType 
* 


* @return The value of the otherType element of the discriminator vector 
* 


* @author LT Steve Shedd 


* 
KKKKKK KKK KKK KKK KK KK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 
public double getDVOtherType () 


{ 
Double value = ( Double )dv.get( "otherType" ); 
return value.doubleValue (); 


/** Set the value of the discriminator vector element otherType */ 
public void setDVOtherType( double value ) 
{ 
this.dv.put( "otherType", new Double( value ) ); 
} 


[[RRRER Discriminate #17 KRKKK | / 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element minOccurs 


+ 


@return The value of the minOccurs element of the discriminator vector 


+ 


@author LT Steve Shedd 


+ 


KKKKKK KKK KKK KK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 
public double getDVMinOccurs () 


Double value = ( Double )dv.get( "minOccurs" ); 
return value.doubleValue (); 


/** Set the value of the discriminator vector element minOccurs */ 
public void setDVMinOccurs( double value ) 


{ 


this.dv.put( "minOccurs", new Double( value ) ); 
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[ [RRR Discriminate #18 ARE E L/ 


/[** KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK 


* Get the value of the discriminator vector element maxOccurs 
@return The value of the maxOccurs element of the discriminator vector 


@author LT Steve Shedd 


+ * OF 


KKKKKK KKK KKK KK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK */ 


public double getDVMaxOccurs () 
{ 


Double value = ( Double )dv.get( "maxOccurs" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element maxOccurs */ 
public void setDVMaxOccurs( double value ) 


{ 


this.dv.put( "maxOccurs", new Double( value ) ); 


[ [RRRRE Discriminate #19 AREAL 

[** KREKKKKK KKK KKK KKK KKK KK KK KKK KK KK KKK KK KKK KK KK KK KKK KKK KK KK KK KK KKK KKK KK KKK KK KK KK KKK 
* Get the value of the discriminator vector element minLength 

@return The value of the minLength element of the discriminator vector 


@author LT Steve Shedd 


tH * OF 


KKK KKK KKK KKK KKK KK KK KKK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public double getDVMinLength () 


{ 
Double value = ( Double )dv.get( "minLength" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element minLength */ 
public void setDVMinLength( double value ) 
{ 


this.dv.put( "minLength", new Double( value ) ); 


[ [RRRKK Discriminate #20 ARE Koff 


[** KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK 


* Get the value of the discriminator vector element maxLength 
@return The value of the maxLength element of the discriminator vector 


@author LT Steve Shedd 


tH * OF 


KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKK */ 


public double getDVMaxLength () 


{ 
Double value = ( Double )dv.get( "maxLength" ); 


return value.doubleValue() ; 
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/** Set the value of the discriminator vector element maxLength */ 
public void setDVMaxLength( double value ) 
{ 


this.dv.put( "maxLength", new Double( value ) ); 


} 


[[RRRRR Discriminate #21 KRKKK | / 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Get the value of the discriminator vector element totalDigits 
@return The value of the totalDigits element of the discriminator vector 


@author LT Steve Shedd 


+ HF 


KKK KKK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK */ 
public double getDVTotalDigits () 


{ 
Double value = ( Double )dv.get( "totalDigits" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element totalDigits */ 
public void setDVTotalDigits( double value ) 


{ 
this.dv.put( "totalDigits", new Double( value ) ); 
} 


[[RRRERR Discriminate #22 KRKKK f / 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK 





* Get the value of the discriminator vector element fractionDigits 
@return The value of the fractionDigits element of the discriminator vector 


@author LT Steve Shedd 


x eK 


KKKKK KKK KK KKK KKK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 


public double getDVFractionDigits () 


{ 
Double value = ( Double )dv.get( "fractionDigits" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element fractionDigits */ 
public void setDVFractionDigits( double value ) 
{ 

this.dv.put( "fractionDigits", new Double( value ) ); 


} 


[ [RRRKK Discriminate #23 seta 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element pattern 
@return The value of the pattern element of the discriminator vector 


@author LT Steve Shedd 


+e FF 


KKKKKKK KKK KKK KKK KKK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKK KKK KKK KKK KKK KK */ 


public double getDVPattern () 

{ 
Double value = ( Double )dv.get( "pattern" ); 
return value.doubleValue(); 
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/** Set the value of the discriminator vector element pattern */ 
public void setDVPattern( double value ) 
{ 


this.dv.put( "pattern", new Double( value ) ); 


[[LRERKR Discriminate #24 KRKKK f / 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the value of the discriminator vector element numEnumerations 
* @return The value of the numEnumerations element of the discriminator vector 


* @author LT Steve Shedd 


* 


KKKKK KKK KK KK KKK KK KK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public double getDVNumEnumerations () 
{ 


Double value = ( Double )dv.get( "numEnumerations" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element numEnumerations */ 
public void setDVNumEnumerations( double value ) 
{ 


this.dv.put( "numEnumerations", new Double( value ) ); 


[ [RRRKK Discriminate #25 RRAER EL] 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKKKKKKKK KKK KK KKK KKK 


* Get the value of the discriminator vector element minExclusive 
@return The value of the minExclusive element of the discriminator vector 


@author LT Steve Shedd 


+ * HF 


KKKK KKK KKK KK KK KK KKK KK KK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK */ 


public double getDVMinExclusive() 
{ 


Double value = ( Double )dv.get( "minExclusive" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element minExclusive */ 
public void setDVMinExclusive( double value ) 


{ 


this.dv.put( "minExclusive", new Double( value ) ); 


[[RRRKK Discriminate #26 AMER Rope 


[** KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Get the value of the discriminator vector element maxExclusive 
* 


* @return The value of the maxExclusive element of the discriminator vector 
* 


* @author LT Steve Shedd 


* 
KKKKKKK KKK KKK KK KK KK KKK KK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public double getDVMaxExclusive () 
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Double value = ( Double )dv.get( "maxExclusive" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element maxExclusive */ 
public void setDVMaxExclusive( double value ) 


{ 


this.dv.put( "maxExclusive", new Double( value ) ); 


} 


[[RERRK Discriminate #27 KEK] / 


[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKK KKK KKK KK KKK KKK 


* Get the value of the discriminator vector element minInclusive 
* 


* @return The value of the minInclusive element of the discriminator vector 
* 


* @author LT Steve Shedd 


* 
KKKKKKK KKK KKK KKK KKK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KK KKK */ 
public double getDVMinInclusive() 


Double value = ( Double )dv.get( "minInclusive" ); 
return value.doubleValue(); 


/** Set the value of the discriminator vector element minInclusive */ 
public void setDVMinInclusive( double value ) 
{ 

this.dv.put( "minInclusive", new Double( value ) ); 


} 


[ [xR Discriminate #28 PR ea fot 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKKK KKK KKK 


* Get the value of the discriminator vector element maxInclusive 
* @return The value of the maxInclusive element of the discriminator vector 


* @author LT Steve Shedd 


* 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKEKEK */ 
public double getDVMaxInclusive() 
{ 
Double value = ( Double )dv.get( "maxInclusive" ); 
return value .doubleValue(); 


/** Set the value of the discriminator vector element maxInclusive */ 
public void setDVMaxInclusive( double value ) 
{ 

this.dv.put( "maxInclusive", new Double( value ) ); 


} 


LITLLLTTLTITLT TTL TITS TTT TLASILA ATTA TTT ATTA TTT TTT TTT TT 
// // 


// Utility Functions Section aE 
Lf // 
SILTLITLITTTLTAT TATA TTT TATA TAT TATA TATA AAA TATA ATA TAT TTA TAIT ATA TAT 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Converts the values of the Discriminator vector elements into a float array. 
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{ 


+ 4 * + + HF 


@author LT Steve Shedd 


@return The discriminator vector as an array of floats 


The ordering of the array elements is critical and conforms to the schema 
outlined in the Correlator module. 


KKKKKK KKK KKK KKK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public float [] 


float [ 


vec 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 


Or 





return 
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new float [28]; 





"propertyType" ) ).floatValue (); 
"isComplex" ) ).floatValue(); 
"numSubTypes" ) ).floatValue(); 
"numReqdSubTypes" ) ).floatValue(); 
"numOptSubTypes" ) ).floatValue (); 
"numOperations" ) ).floatValue(); 
"numParameters" ) ).floatValue(); 
"stringType" ) ).floatValue(); 
"booleanType" ) ).floatValue(); 
"floatType" ) ).floatValue(); 
"doubleType" ) ).floatValue(); 
"bigDecimalType" ) ).floatValue(); 
"intType" ) ).floatValue(); 
"longType" ) ).floatValue(); 
"shortType" ) ).floatValue(); 
"otherType" ) ).floatValue(); 
"minOccurs" ) ).floatValue(); 
"maxOccurs" ) ).floatValue(); 
"minLength" ) ).floatValue(); 
"maxLength" ) ).floatValue(); 
"totalDigits" ) ).floatValue(); 
"fractionDigits" ) ).floatValue(); 
"pattern" ) ).floatValue(); 
"numEnumerations" ) ).floatValue(); 
"minExclusive" ) ).floatValue(); 
"maxExclusive" ).floatValue(); 
"minInclusive" ) ).floatValue(); 
"maxInclusive" ) ).floatValue(); 


’ 


ValuesAsF loatArray () 
vector = 

0 = ((Double) dv. 
1 = ((Double) dv. 
2 = ((Double) dv 
3 = ((Double) dv 
4 = ((Double) dv 
5 = ((Double) dv 
6 = ( (Double) dv 
7 = ((Double) dv. 
8 = ((Double) dv 
] = ((Double) dv 
10] = ((Double) dv 
11] = ((Double) dv 
12] = ((Double) dv 
13] = ((Double) dv. 
14] = ((Double) dv. 
15] = ((Double) dv. 
16] = ((Double) dv. 
17] = ((Double) dv. 
18] = ((Double) dv. 
19] = ((Double) dv. 
20] = ((Double) dv. 
21] = ((Double) dv. 
22] = ((Double) dv. 
23] = ((Double) dv. 
24] = ((Double) dv 
25] = ((Double) dv. 
26] = ((Double) dv 
27] = ((Double) dv 
vector; 


} // End ValuesAsFloatArray 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
he 
// 
// 
// 
// 
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// 
// 
// 
// 
// 
// 
// 
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property 
property 
property 
property 
property 
property 
property 
property 
property 
proper 
proper 
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[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKK KKK KKK KK KKK KK 


{ 


* 


++ * * + HF F 


@author LT Steve Shedd 


@return The discriminator vector as an array of doubles 


Converts the values of the Discriminator vector elements into a double array. 
The ordering of the array elements is critical and conforms to the schema 
outlined in the Correlator module. 


KKKKK KKK KKK KKK KK KKK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK */ 


public double[] 


double 


vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 
vector 





] 


MIATA BFWNHEO 

















ValuesAsDoubleArray () 

vector = new double[28]; 
= ((Double) dv.get ("propertyType" ) ).doubleValue(); 
= ((Double) dv.get ("isComplex" ) ) .doubleValue(); 
= ((Double)dv.get ("numSubTypes" ) ).doubleValue(); 
= ((Double) dv.get ("numReqdSubTypes" ) ).doubleValue(); 
= ((Double)dv.get ("numOptSubTypes" ) ).doubleValue(); 
= ((Double)dv.get ("numOperations" ) ).doubleValue() ; 
= ((Double)dv.get ("numParameters" ) ).doubleValue(); 
= ((Double)dv.get ("stringType" ) ) .doubleValue(); 
= ((Double) dv.get ("booleanType" ) ).doubleValue(); 
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// 
// 
// 
// 
// 
// 
// 
// 
// 


property 
property 
property 
property 
property 
property 
property 
property 
property 


WOANHDUBWNHE 


} 

















vector[9] = ((Double)dv.get ("floatType" ) ).doubleValue(); // property 
vector[10] = ((Double)dv.get ("doubleType" ) .doubleValue(); // property 
vector[11] = ((Double) dv.get ("bigDecimalType" ) ).doubleValue(); // property 
vector[12] = ((Double)dv.get ("intType" ) ).doubleValue(); // property 
vector[13] = ((Double)dv.get ("longType" ) ).doubleValue(); // property 
vector[14] = ((Double)dv.get ("shortType" ) ).doubleValue(); // property 
vector[15] = ((Double)dv.get ("otherType" ) ).doubleValue() // property 
vector[16] = ((Double)dv.get ("minOccurs" ) ).doubleValue(); // property 
vector[17] = ((Double)dv.get ("maxOccurs" ) ).doubleValue () // property 
vector[18] = ((Double)dv.get ("minLength" ) ) .doubleValue () // property 
vector[19] = ((Double)dv.get ("maxLength" ) ).doubleValue(); // property 
vector[20] = ((Double)dv.get ("totalDigits" ) ) .doubleValue(); // property 
vector[21] = ((Double)dv.get ("fractionDigits" ) ).doubleValue(); // property 
vector[22] = ((Double)dv.get ("pattern" ) ).doubleValue(); // property 
vector[23] = ((Double)dv.get ("numEnumerations" ) ).doubleValue(); // property 
vector[24] = ( (Double) dv.get ("minExclusive" ) ).doubleValue(); // property 
vector[25] = ((Double)dv.get ("maxExclusive" ) ).doubleValue(); // property 
vector[26] = ((Double)dv.get ("minInclusive" ) ).doubleValue(); // property 
vector[27] = ((Double)dv.get ("maxInclusive" ) ).doubleValue(); // property 
return vector; 

// End ValuesAsDoubleArray 
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18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


public void mergeChildWithParent ( DiscriminatorVector child ) 


{ 


* Merges the unnormalized values of a child discriminator vector with the 


* parent discriminator vector whos merge method is being invoked. 
method is specifically designed to aid in the dicriminator vector 


summations for complex types. 
@param A raw, 


@return None 


@author LT Steve Shedd 


+ + + FH * FF HK 


This 


unnormalized discriminator vector that is considered to 
be a child of the discriminator vector invoking the merge method. 


@throws Exception - if there is a general error in the merge process 


KKK KK KKK KKK KKK KKK KK KK KKK KK KK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKK */ 


// Check to see of either vector has been normalized already. 


// then cannot add together. 
if ( this.isNormalized() || 
{ 
throw new Exception ( 
"are already normalized." ); 
} 
else 
{ 


double[] temp = 


// This covers the cases of attr + attr, 


// and oper + oper. 


if ( this.getDVPropertyType () 
{ 

temp[0] = 1.0; 
} 
else 
{ 

temp[0] = 0.0; 
} 
// Merging 
// vector, 
temp[1] = 1.0; 





new double[28]; 


== 1.0 


attr + oper, 


child.getDVPropertyType () 


throws Exception 


If so, 


child.isNormalized() ) 


"Cannot merge discriminator vectors that" + 


oper + attr, 


two discriminator vectors automatically results in a complex 
or a value of 1.0 in our schema. 


// The parent vector must include the number of subtypes under the parent. 
// If the child has no associated subtypes, 
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add 1 to the parent to 


// count the child as a subtype. Else, add the number of subtypes of the 
// child to the subtypes of the parent plus 1.0 to account for the child 
// itself. 
if ( child.getDVNumSubTypes() == 0.0 ) 
{ 
temp[2] = this.getDVNumSubTypes() + 1.0; 
} 
else 
{ 
temp[2] = this.getDVNumSubTypes() + child.getDVNumSubTypes() + 1.0; 





} 


// A type is required only if the minOccurs discriminant equals is 

// equal to or greater than 1.0. If the child has no tallies for subtypes 

// and the child's minOccurs is 1.0 or greater, then add the value of the 

// child minOccurs to the parent. Else, add 0.0 to the parent. 

//if ( child.getDVNumReqdSubTypes() == 0.0 && child.getDVMinOccurs() >= 1.0) { 
if ( child.getDVMinOccurs() >= 1.0 ) 

{ 


temp[3] = this.getDVNumReqdSubTypes() + child.getDVNumReqdSubTypes() + 1.0; 
} 
else 
{ 

temp[3] = this.getDVNumReqdSubTypes() + child.getDVNumReqdSubTypes () ; 


} 


// A type is optional only if the minOccurs discriminant equals 0.0. 

// If the child minOccurs is equal to 0.0 and the child has no tallies 
// for subtypes, then add 1.0 to the parent. Else, add the value of the 
// child NumOptSubTypes to the parent. 


//if ( child.getDVNumOptSubTypes() == 0.0 && child.getDVMinOccurs() == 0.0) { 
if ( child.getDVMinOccurs() == 0.0 
{ 
temp[4] = this.getDVNumOptSubTypes() + child.getDVNumOptSubTypes() + 1.0; 
} 
else 
{ 
temp[4] = this.getDVNumOptSubTypes() + child.getDVNumOpt SubTypes () ; 


} 


// A discriminator vector describes an operation if its property type 

// equals 0.0. If the child's propertyType equals 0.0 and the child has 
// no tallies for subtypes, i.e. numOperations equals 0.0, then add 1.0 
// to the parent. Else, add the child value to the parent. 


if ( this.getDVPropertyType() == 0.0 && this.getDVNumOperations() == 0.0 ) 
{ 
temp[5] = this.getDVNumOperations() + 1.0; 
} 
else 
{ 
temp[5] = this.getDVNumOperations() + child.getDVNumOperations (); 


} 


// simple addition for the following 





























temp[6] = this.getDVNumParameters() + child.getDVNumParameters () ; 
temp[7] = this.getDVStringType() + child.getDVStringType() ; 

temp[8] = this.getDVBooleanType() + child.getDVBooleanType () ; 
temp[9] = this.getDVFloatType() + child.getDVFloatType(); 

temp[10] = this.getDVDoubleType() + child.getDVDoubleType() ; 
temp[11] = this.getDVBigDecimalType() + child.getDVBigDecimalType(); 
temp[12] = this.getDVIntType() + child.getDVIntType(); 

temp[13] = this.getDVLongType() + child.getDVLongType() ; 

temp[14] = this.getDVShortType() + child.getDVShortType () ; 

temp[15] = this.getDVOtherType() + child.getDVOtherType(); 

// T£ both vectors are optional, the resultant is optional. If either 
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// or both are mandatory, 


if ( this.getDVMinOccurs() >= 1.0 || 
{ 
temp[16] = 1.0; 
} 
else 
{ 
temp[16] = 0.0; 


} 





then the resultant is mandatory. 
child.getDVMinOccurs () 


>= 1.0 ) 


+ child.getDVMinLength () ; 
+ child.getDVMaxLength () ; 
+ child.getDVTotalDigits(); 


+ child.getDVFractionDigits(); 


+ child.getDVPattern(); 


+ child.getDVNumEnumerations (); 
child.getDVMinExclusive(); 
child.getDVMaxExclusive 
child.getDVMinInclusive 


, 


// Tf the resultant vector is an attribute 

if ( temp[0] == 1.0 

{ 
double x = this.getDVMaxOccurs(); 
double y = child.getDVMaxOccurs (); 
temp[17] = x+y; 
temp[18] = this.getDVMinLength () 
temp[19] = this.getDVMaxLength () 
temp[20] = this.getDVTotalDigits () 
temp[21] = this.getDVFractionDigits () 
temp[22] = this.getDVPattern () 
temp[23] = this.getDVNumEnumerations () 
temp[24] = this.getDVMinExclusive() + 
temp[25] = this.getDVMaxExclusive() + 
temp[26] = this.getDVMinInclusive() + 
temp[27] = this.getDVMaxInclusive() + 

















} 


f values and insert 


i 


// Perform addition o 
this.setDVPropertyType( temp[0] 
.setDVIsComplex( temp[1] ); 
.-setDVNumSubTypes( temp[2] ); 
.setDVNumReqdSubTypes ( temp[3] 
.setDVNumOptSubTypes ( temp[4] 
.setDVNumOperations( temp 
-setDVNumParameters ( temp 
.setDVStringType( temp[7] ); 
.setDVBooleanType( temp[8 
.setDVFloatType( temp[9] ); 
-setDVDoubleType( temp[10] ); 
.setDVBigDecimalType( temp[11] 
.setDVIntType( temp[12] ); 





atattatta tae 
(2) 
B 
n 





i 


his.setDVLongType( temp[13] ); 
his.setDVShortType( temp[14] ); 
his.setDVOtherType( temp[15] ); 
is.setDVMinOccurs( temp[16] ); 
his.setDVMaxOccurs( temp[17] ); 
his.setDVMinLength( temp[18] ); 
his.setDVMaxLength( temp[19] ); 


his.setDVTotalDigits( temp[20] ); 
-setDVFractionDigits( temp[21] 


-setDVPattern( temp[22] ); 


; 














tdtdetet ete eee tee tee 
2) 
B 
an 











his.setDVNumEnumerations( temp[23] ); 
his.setDVMinExclusive( temp[24] ); 
his.setDVMaxExclusive( temp[25] ); 
his.setDVMinInclusive( temp[26] ); 
his.setDVMaxInclusive( temp[27] ); 


} 


} // End mergeChildWithParent 
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Q 
QO; 
child.getDVMaxInclusive () 


, 


into new discriminator vector. 


5. Interface NeuralNetGenerator 


J [BRK KR KKK KK KA A KKK AAR A ee AAA A A Ae ee IIA AAA A A ee IIA A A A A He He He oe 


// NeuralNetGenerator. java 

// SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Sun JDK 1.3.1_04 

] J: LT Steve Shedd, USN 

7% Naval Postgraduate School, Monterey, California 

// September 2002 





J [RRR RRR KKK KK KR KR KK KH KKKKK KKK KKK KKK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKK KKK KK 


package mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator; 
import java.util.List; 


import mwa.ai.neural.Neural; 
import mwa.ai.neural.NNfile; 


[** KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKK KKK KK 


<br> 


* The <i>NeuralNetGenerator</i> interface defines the services that must be 

* provided by the a neural network generator implementation to the component model 
* correlator. The class <i>ComponentModelCorrelator</i> uses this interface to 

* perform the creation of trained neural networks. 

* 

* @author LT Steve Shedd 

* @version v1.0 September 2002 

* 


KKK KKKKKKKKKKKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KK KK KKK KK KK KKK KOK */ 


public interface NeuralNetGenerator 


{ 


[** KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKK KKK KKK 
* <br> 

* Returns a trained neural network for the list of discriminator vectors 

* passed as the parameter. 


@param discriminators —- the list of discriminator vectors needed to 
build the neural net. 
@return a trained neural network. 


@author LT Steve Shedd 


+ + + FF HF 


KKKKKK KKK KKK KKK KK KK KKK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKKKKKK KKK KKK KKK KKK KK */ 


public Neural generateNeuralNet ( List discriminators )j; 


/[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* <br> 

* Makes a formatted file to represent the trained neural network. 
* Returns true if the 

* file io was successful, false otherwise. 

* 


* @param nn —- a trained neural network. 
* @param path - the path to be used to save the neural network file to disk. 
@return true if the file was created and saved, false otherwise. 


* 


@author LT Steve Shedd 


4 + # 


KKKKKKKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK */ 


public boolean makeFile( Neural nn, String path ); 


} // End NeuralNetGenerator 
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6. Class NeuralNetGeneratorImpl 


J [BRR KR KKK KK KA I KKK AAA A Ae IAA AA A Ae eA AAA A A ee IAA AA A He He ee 


// 
// 
// 
// 
// 
// 
// 


FSTLCN AMG? ceo ererne ete te NeuralNetGeneratorImpl. java 

Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 

Original Compiler:....Sun JDK 1.3.1_04 

AUCH O Bio Sis esl eaedne detest LT Steve Shedd, USN 

CONNO BTU 02a cacacalacacacelacdcaca.a Naval Postgraduate School, Monterey, California 

Dates a renentne-onguenenesengnenetiens September 2002 


J [BRK KKK KK KKK A KKK AAR A ee RAR AA A A ee AAA AA A ee IIA A A A A He He oe oe 


package mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator; 


import java.util.List; 
import java.util.ArrayList; 
import java.util.Iterator; 
import java.util.Vector; 


import mwa.ai.neural.Neural; 
import mwa.ai.neural.NNfile; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KK Kk kk kk kk KK KKK KKK KK KK KK KKK 


* 


* 


+ + F FF 


<br> 

The <i>NeuralNetGeneratorImpl</i> performs the generation and training 
of neural networks 

for use in the syntactic correlation process. 


@author LT Steve Shedd 
@version v1.0 September 2002 


KKK KKKKKKKKKKKK KKK KKK KKK KKK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KK */ 


public class NeuralNetGeneratorImpl implements NeuralNetGenerator 


{ 


/** number of input layer nodes for the neural network */ 
static final int NUM_INPUT_NODES = 28; 


/** number of hidden layer nodes for the neural network */ 
private int numHiddenNodes = 0; 





/** number of output layer nodes for the neural network */ 
private int numOutputNodes = 0; 


/** Neural network learning rate */ 
private float neuralLearningRate = 0.25f; 


/** Max number of Epochs allowed during neural network training */ 
private int neuralMaxEpochs = 100000; 


/** Output vector error tolerance for training the neural network */ 
private double neuralOutputErrorTolerance = 0.1; 


/** Default Constructor */ 


public NeuralNetGeneratorImpl () 
{ 


} 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
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<br> 

Returns a trained neural network for the list of discriminator vectors 
passed as the parameter. The implementation provided below is convoluted due 
to the use of the mwa.ai.neural package. In order to optimize the code, the 
mwa.ai.neural package should be completely rewitten. 


@param discriminators - the list of discriminator vectors needed to 
build the neural net. 


@return a trained neural network. 


@author LT Steve Shedd 


+ + + F FF FF FH FH 


KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KEKE */ 
public Neural generateNeuralNet ( List discriminators ) 


{ 


// Get the number of output nodes 
numOutputNodes = discriminators.size(); 


// Calculate the number of hidden layer nodes 
numHiddenNodes = numOutputNodes + this.NUM_INPUT_NODES / 2; 


// Create the binary output vectors 
List trainingOutputVectors = this.generateTrainingOutputVectors (numOutputNodes) ; 


// Create an instance of a neural network 
Neural localNeural = new Neural( this.NUM_INPUT_NODES, 
numHiddenNodes, numOutputNodes ); 


// Convert the input vectors in a single large float array 
float[] inputs = this.convertVectorsIntoFloatArray( discriminators ); 


// Convert the output vectors into a single large float array 
float[] outputs = this.convertVectorsIntoFloatArray( trainingOutputVectors ); 


// Set the number of training cases 
int numTrainingCases = discriminators.size(); 
localNeural.NumTraining = discriminators.size(); 


// Create a local variable to track the output error of training 
float outputError = 0; 


// Create a local variable to track the number of training epochs gone past 
int epochCount = 0; 


// Perform the training until the max epocsh preference is reached or until 
// the output error is less than the output error tolerance. Note: the training 
// process sets the weight matrices of the Neural Net object. 
for ( int i= 0; i < this.neuralMaxEpochs; i++ ) 
{ 
outputError = localNeural.Train( inputs, outputs, numTrainingCases, 
this.neuralLearningRate ); 
epochCount++; 


if ( outputError < this.neuralOutputErrorTolerance ) 


{ 


break; 
} 
} 
System.out.println( "\n\nNetwork trained after " + epochCount + " epochs." ); 
System.out.printin( "\nError is: " + Float.toString( outputError ) ); 


// return the trained neural netword object 
return localNeural; 


} // End generateNeuralNet 
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[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* 


* 


* 


* 


* 


* 


* 


* 


4 + ¥ 


<br> 

Makes a formatted file to represent the trained neural network. 
Returns true if the 

file io was successful, false otherwise. 


@param nn - a trained neural network. 
@param path - the path to be used to save the neural network file to disk. 


@return true if the file was created and saved, false otherwise. 


@author LT Steve Shedd 


KKKKKKK KKK KKK KKK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK */ 


public boolean makeFile( Neural nn, String path ) 


{ 


} 


try 


nn.Save( path ); 
return true; 


catch ( Exceptione ) 


e.printStackTrace(); 
return false; 





// End makeFile 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* 


+ + * FF F HH HK 


+ + + + + FH F H OF 


<br> 

Returns a list of binary output vectors to be used in the training of 

the neural network. The number of output vectors is equal to the number of 
discriminator vectors passed into the generateNeuralNet method. In this 
implementation, each output vector is represented as an array of floats. The 
ouput vectors contian a binary patterns that distinguish each output node. An 
example for four output nodes is shown below: 

<br><br> 


output node 1 { 1.0, 0.0, 0.0, 0.0 } 
output node 2 { 0.0, 1.0, 0.0, 0.0 } 
output node 3 { 0.0, 0.0, 1.0, 0.0 } 
output node 4 { 0.0, 0.0, 0.0, 1.0 } 


<br><br> 

Since the output nodes of the neural network represent the attribuates of the 
FCR, the unique output patterns ensure that the neural network will match an 
FCR attribute given the correct input. 


@param numOutputNodes - the number of output nodes for the neural network 
@return A list containing the output vectors as float arrays 


@author LT Steve Shedd 


KKK KKK KKK KKK KKK KK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


public List generateTrainingOutputVectors( int numOutputNodes ) 


{ 


List results = new ArrayList (); 


for ( int nodeID = 0; nodeID < numOutputNodes; nodeID++ ) 
{ 

// Create a new float array 

float[] vector = new float [numOutputNodes]; 


// Populate the array 
for ( int index = 0; index < vector.length; indext+ ) 
{ 

if ( index == nodeID ) 


{ 
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vector[index] = 1.0f; 
} 
else 
{ 

vector[index] = 0.0f; 
} 


} 
// Add the newly created output vector to the list 
results.add( vector ); 


} 
return results; 


} // End generateTrainingOuputVectors 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 
* <br> 
* Returns a single float array representation of the list of vectors 
* passed in as the parameter. This is utility function is required in order to 
* convert the data into a format recognizable by the mwa.ai.neural.Neural class. 
<b>The list of input vectors must be float arrays in this 
method.</b> A function for 
doubles can be easily created by copying this method. 


@param vectors - a list of discriminator vectors or desired output vectors. 
@return A single float array resulting from the merger of the input vectors. 


@author LT Steve Shedd 


+ +e FF HH * 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KK */ 


public float[] convertVectorsIntoFloatArray( List vectors ) 


{ 


// Get the size of the first array in the list. The other arrays in the 

// list should be the same size given the process to get here. An input list 
// is either for discriminator vectors, in which case the size of each array 
// is 28, or an list of deired output vectors, in which case the size of each 
// array is equal to the number of output vectors of the neural network. 

int arrayLength = ( ( float[] ) vectors.get( 0 ) ).length; 


// Create a singel dimension float array to hold all the arrays passed in 
// vectors list. This is the number of arrays in the list * the size 

// of each array. 

float[] results = new float[ vectors.size() * arrayLength ]; 


// Create a singleton counter to help add floats to the results array 
int counter = 0; 


// Get an iterator for the input list 
Iterator vectorIter = vectors.iterator(); 


while ( vectorIter.hasNext() ) 


{ 
// Get the float array contained in the list 
float[] vector = ( float[] ) vectorIter.next(); 


// Add each element of the float array to our results array 
for ( int i = 0; i < vector.length; i++ ) 


{ 


results[countert+t+] = vector[i]; 


} 


return results; 


} // End makeFile 
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} // End of NeuralNetGeneratorImpl 


C. PACKAGE: mil.navy.nps.cs.babel.Correlator.semanticSearc hEngine 


I Be Interface SemanticSearchEngine 
J [RRR RK KK KK RA KAA AA A ee AAA A A Ae AAA A A Ae ee IIA A A A A ee oe oe 
Lf FATS aAMS Rees eae See 3 SemanticSearchEngine. java 
// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 
// Oviginal Compiler:....Sun JDK 1.3.1_04 
hh] PUCK OES ain cot shoe cris 8 es LT Steve Shedd, USN 
Lf (COMPANY © 5.8 ask k ecteek dno Re Naval Postgraduate School, Monterey, California 
Le DAC ON 8b Gneceteeiege es pate eh e-¥ September 2002 


J [BRR KR KKK KKK A A I KKK AAA A ee AAA A A ee IAA AAA A A ee IAA A A A He He He oe 


package mil.navy.nps.cs.babel.Correlator.semanticSearchEngine; 


import java.util.List; 
import java.util.Hashtable; 


import mil.navy.nps.cs.oomi.fiom.CCR; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKKKKKKK 
* <br> 

The <i>SemanticSearchEngine</i> interface defines the services that must be 

provided by the a semantic search engine implementation to the component model 
correlator. The class <i>ComponentModelCorrelator</i> uses this interface to 
perform the semantic correlation phase of the component model correlator. 


@author LT Steve Shedd 
@version vl.0 September 2002 


* 
* 
* 
* 
* 
* 
* 
* 
* 


KEK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


public interface SemanticSearchEngine 


{ 


[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
* <br> 

Returns a double dimension array with the name of the FEV and 

associated score for 

every FCR passed into the method via the fcrList parameter. The 

format of the return 

array is specific. Each element of the array consists of a subArray 
with the following 

objects: 

<br> 

<br> 

index 0: The name of the FEV as a String object. 

<br> 

index 1: The score of the FCR-CCR semantic comparison as a Float object. 
<br> 

<br> 

The other members of the component model correlator rely on this 

format and it cannot 

be changed. 


+ + + FF F F F F F FF F F FF F HF OF 


@param fcrList - the list of FCRs to be semantically compared against the CCR 
@param currentCCR - the candidate CCR for which correlation is desired 
@return a double dimension array containing the FEV names and 

corresponding scores. 


@author LT Steve Shedd 


+ + * * ¥ 


KKKKK KKK KKK KKK KKK KK KK KK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public Object[] [] runSemanticSearch( List fcrList, CCR currentCCR ); 
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// 
// 
// 
// 
// 
// 


// End SemanticSearchEngine 


2. Class SemanticSearchEngineImpl 
J [BRK RK KK KK RA I KKK A AA A ee AAA A A ee IAA AA A A ke IAA A A A He He oe Oe 
Pailename + 5...5-$c-3o08- 835s SemanticSearchEngineImpl. java 
Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 
Original Compiler:....Sun JDK 1.3.1_04 
AUGCHOPS sc Sea dees e438 LT Steve Shedd, USN 
COMPBIIY Sos. aGlace las are adele Naval Postgraduate School, Monterey, California 
DAE. SE See lesa las 6 Tarterte Gta latle io fecloees September 2002 


// 


J [BKK KK KK KKK A KKK AA A ee IAA AA A ke ee AAA A Ae ke IIA A A A A ee oe oe 


package mil.navy.nps.cs.babel.Correlator.semanticSearchEngine; 


import java.util.List; 
import java.util.Iterator; 
import java.util.Hashtable; 
import java.util.ArrayList; 


import mil.navy.nps.cs.oomi.fiom.CCR; 
import mil.navy.nps.cs.oomi.fiom.FCR; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK kk kk KK KK KK KK KK KK KK KKK 


* 


+ + FF HF ¥ HF HH 


* 


<br> 

The <i>SemanticSearchEngineImpl</i> class performs the semantic 

correlation phase of the 

component model correlator. The meat of the correlation is contained within the 
<i>runSemanticSearch</i> method. Should future work require a change to the 
implementation of the semantic correlation process, it is hoped 

that only this class 

will have to be modified. 


@author LT Steve Shedd 
@version v1.0 September 2002 


KKK KKK KKKKKKKKKKKK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KK KKK KK */ 


public class SemanticSearchEngineImpl implements SemanticSearchEngine 


{ 


/** Member variable to hold the results of the semantic search. */ 
Object[] [] semanticResults = null; 


/** Default constructor */ 
public SemanticSearchEnginelImpl () 


{ 
} 


/[** KKK KKK KK KK KK KK KK KK KK ee ee 


* <br> 


* Returns a double dimension array with the name of the FEV and 

* associated score for 

* every FCR passed into the method via the fcrList parameter. The 
* format of the return 

* array is specific. Each element of the array consists of a subArray 
* with the following 

* objects: 

* <br> 

* <br> 

* index 0: The name of the FEV as a String object. 

* <br> 
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index 1: The score of the FCR-CCR semantic comparison as a Float object. 
<br> 

<br> 

The other members of the component model correlator rely on this 

format and it cannot 

be changed. 


@param fcrList - the list of FCRs to be semantically compared against the CCR 
@param currentCCR - the candidate CCR for which correlation is desired 
@return a double dimension array containing the FEV names and 

corresponding scores. 


@author LT Steve Shedd 


+ + + * Fe + HF FF KF H FF 


KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK */ 
public Object[] [] runSemanticSearch( List fcrList, CCR currentCCR ) 
{ 


// Reset score variables 
float fcrScore = 0; 


// Size the results double dimension array 
semanticResults = new Object[ fcrList.size() ] [2]; 


// Variable used in the while loop below to identify which row of the 
// semanticResults array to record the semantic score. 
int fer = 0; 


// Get the CCR keywords 
String[] ccrKeywords = currentCCR.getCCRSemantics().getKeywordList (); 


// Get an iterator for the FCR list 
Iterator fcrIter = fcrList.iterator(); 


// For each FCR in the FIOM 
while ( fcrIter.hasNext() ) 
{ 


// Reset score variables 
fcrScore = 0; 


// Get a local copy of the FCR 
FCR localFCR = ( FCR )fcriter.next (); 


// Get the keywords for the FCR 
String[] fcrKeywords = localFCR.getFCRSemantics().getKeywordList (); 


// Calculate the score for the FCR. Total match count 
// divided by the total number of keywords for the CCR. 
fcrScore = runComparisonForScore( fcrKeywords, ccrKeywords ); 


// Add the results to the semanticResults double dimention array. 
// The following schema is used for the array: 


// index 0: FEV Name 

1a index 1: FCR Score 

semanticResults[fcr] [0] = new String( localFCR.getFCRName() ); 
semanticResults[fcr] [1] = new Float( fcrScore ); 


// Incremenet the FCR counter variable 
feort+t; 


} 


// Sort the results 
mergeSort ( semanticResults, 0, semanticResults.length - 1 ); 


// Return the semantic results array. 
return semanticResults; 
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} // End runSemanticSearch 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 
* <br> 
* Returns the semantic comparison score for the FCR and CCR comparison. 
The implementation 
of the comparison is contained within this method and can be changed 
without affecting 
the rest of the semantic search engine. 


* 
* 
* 
* 
* 
* @param fcrWords —- the list of keywords for the FCR being tested 
* @param ccrWords - the list of keywords for the CCR being tested 
* @return a semantic comparison score for the FCR 

* 

* 

* 

* 


@author LT Steve Shedd 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK EK */ 


private float runComparisonForScore( String[] fcrWords, String[] ccrWords ) 


{ 


float fcrScore = 0; 
int matchCount = 0; 


// For each word in the FCR keyword list, compare it with each word 
// from the CCR keyword list. Keep track of the matches and compute 
// a percentage score. 
for ( int i = 0; i < ccrWords.length; it+ ) 
{ 
for ( int j = 0; j < fcrWords.length; j++ ) 
{ 
if ( ( ( String )ccrWords[i] ).equalsIgnoreCase( fcrWords[j] ) ) 
{ 
matchCount += 1; 


} 
} 
// Must cast the numerator and denominator to floats before the 
// division operation. Otherwise, the integer division will return the 
// floor of a number less than 1, which will always be 0. 
ferScore = ( float )matchCount / ( float )ccrWords.length; 


return fcrScore; 


} // End runComparisonForScore 


* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 
<br> 

Implementation of of the merge-sort algorithm for the double 
dimension array used 
to store the FEV/score pairs. The first column in the array must 
contain the names 

of the FEVs and the second column must contain the scores as 
floats. This is an 
optimal sorting algorithm which executes in O(n lg n ) in the worst 
case scenario. This 

implementation sorts the array in descending order based on the 
scores of the FEVs 

contained in the array. 


@param A — a double dimension array containing the FEV/Score 
results to be sorted 

@param indexLo - The start index of the array 

@param indexHi - The end index of the array 


@author LT Steve Shedd 


+ + + F FF FF FF F FF FF F HH HH 
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KKK KKK KKK KKK KKK KK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KK 


private void mergeSort( Object[] [] 


{ 


indexLo; 
indexHi; 


int lo 
int hi = 
TE aul 
{ 


lo >= hi ) 


return; 


} 


// Determine the value of mid. 


// int mid = ( 


lo + hi ) 


pee 


A, 


int indexLo, 


// Determine the value of mid in double form. 
Double doubMid = new Double( Math.floor( ( 


// Get mid as an integer value 
int mid = doubMid.intValue(); 


lo + hi ) 


int indexHi ) 


Po QZ y YG 


//Partition the list into two lists and sort them recursively 


mergeSort( A, lo, 
mergeSort( A, mid + 


mid ); 


1, hi ); 


//Merge the two sorted lists 


int end_lo = mid; 
int start_hi = 
while ( ( 


{ 


mid + 1; 
lo <= end_lo ) 


&& ( 


// Check the float values in the array. 


start_hi <= hi ) 


) 


if ( ( ( Float )A[lo] [1] ).floatValue() > 
( ( Float )A[start_hi] [1] ).floatValue() ) 
{ 
lot+; 
} 
else 
{ 
/* 
* allo] >= al[start_hi] 
* The next element comes from the second list, 
move the a[start_hi] element into the next 
* position and shuffle all the other elements up. 
a7. 
Object[] temp = A[start_hi]; 
for ( int k = start_hi - 1; k >= lo; k-- ) 
{ 
A(tk + 1] = A[k]; 
} 
A[lo] = temp; 
lott; 
end_lott+; 


start_hi+t+; 


} // End mergeSort 


// End SemanticSearchEngineImp1l 
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iar 


D. PACKAGE: mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine 


1F Interface SyntacticSearchEngine 
J [BRK RR KKK KKK A I KKK AAR A ee IIA AAA A ee IAA AAA ee IAA A A A He He oe oe 
// Filename:............. SyntacticSearchEngine. java 
// Parent PYOTECES ie Se sigyete SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 
// Original Compiler:....Sun JDK 1.3.1_04 
Ef PUBR OT Sisii5 208 satin doe he oes LT Steve Shedd, USN 
//: Company Ves 3s yeas 3a s24 Naval Postgraduate School, Monterey, California 
Lif, Dae Crib snes Sheol eae snst ccehcou itt September 2002 


J [BRR KR KKK KK KA A I KKK AAA A ee IAA AA A ee AAA AAA ee IAA A AA A He He He Oe 


package mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine; 
import java.util.List; 


import mil.navy.nps.cs.oomi.fiom.CCR; 


[** Ae MM MH NH KERRIER ER EE ERE ERE ER EERE ER EERE RERERER ER ERE ER ERE KERR ERER KERR ERE 
* <br> 

The <i>SyntacticSearchEngine</i> interface defines the services that must be 

provided by the a syntactic search engine implementation to the component model 
correlator. The class <i>ComponentModelCorrelator</i> uses this interface to 

perform the syntactic correlation phase of the component model correlator. 


@author LT Steve Shedd 
@version vl.0 September 2002 


+ + * F H OF 


KREKKKKKKKKK KKK KKK KKK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KOK */ 


public interface SyntacticSearchEngine 


{ 


[** KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK 


* <br> 

Returns a double dimension array with the name of the FEV and 
associated score for 

every FCR passed into the method via the fcrList parameter. The 
format of the return 

array is specific. Each element of the array consists of a subArray 
with the following 

objects: 

<br> 

<br> 

index 0: The name of the FEV as a String object. 

<br> 

index 1: The score of the FCR-CCR syntactic comparison as a Float object. 
<br> 

<br> 

The other members of the component model correlator rely on this 
format and it cannot 

be changed. 


@param fcrList - the list of FCRs to be syntactically compared against the CCR 
@param currentCCR - the candidate CCR for which correlation is desired 

@return a double dimension array containing the FEV names and 

corresponding scores. 


@author LT Steve Shedd 


+ + £ + F F FF FF FF F F FF F FF F F KF F OF 


KKK KKK KK KK KK KKK KK KK KK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 


public Object[] [] runSyntacticSearch( List fcrList, CCR currentCCR ); 


} // End SyntacticSearchEngine 
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Ze Class SyntacticSearchEngineImpl 


J [BRK KR KKK KK KA A KKK AAA A ee AAA AA A Ae AAA A A A ee IA A A A A He He He oe 


// Filename:............. SyntacticSearchEnginelImpl. java 

// Parent PYOVNSCU ey Gecwe es SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Oviginal Compiler:....Sun JDK 1.3.1_04 

[if PORNO G-Scale, Sd LT Steve Shedd, USN 

ff COMPANY ie cece age oe bcd ek Naval Postgraduate School, Monterey, California 

Life? DAC GE ie Sheree gence gveneneses September 2002 


J [BR KKK KKK KK Re IKK AAA A ee AAA A A ke Ae IAA AA A Ae ee IAA A A A ee oe oe 


package mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine; 


import java.util.List; 
import java.util.Iterator; 
import java.util.Hashtable; 
import java.util.ArrayList; 
import java.util.Arrays; 


import mwa.ai.neural.*; 


import mil.navy.nps.cs.oomi.fiom.*; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK kk kk kk KK KK KK KKK KKK KK KKK 
* <br> 

The <i>SynatacticSearchEngineImpl</i> class performs the syntactic 

correlation phase of the 

component model correlator. The meat of the correlation is contained within the 
<i>runSyntacticSearch</i> method. Should future work require a change to the 
implementation of the syntactic correlation process, it is hoped 

that only this class 

will have to be modified. 


+ + + F FF + HF 


@author LT Steve Shedd 
@version v1.0 September 2002 


KR KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK 


+ 


@testcase 


test.mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine.TestSyntacticSearchEngineImpl 
* 


KKRKKKKKKKK KKK KKK KKK KK KK KK KK KK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KK */ 
public class SyntacticSearchEngineImpl implements SyntacticSearchEngine 


{ 
/** Member variable to hold the results of the syntactic search. */ 


Object[] [] syntacticResults = null; 


/** Default constructor */ 
public SyntacticSearchEngineImpl () 


{ 
} 


[** KR KKK KKK KKKKKK KKK KKK KKK KKK KKK KK KKK KKK KK KK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


* <br> 


* Returns a double dimension array with the name of the FEV and 

* associated score for 

* every FCR passed into the method via the fcrList parameter. The 
* format of the return 

* array is specific. Each element of the array consists of a subArray 
* with the following 

* objects: 

* <br> 

* <br> 

* index 0: The name of the FEV as a String object. 

* <br> 
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* index 1: The score of the FCR-CCR syntactic comparison as a Float object. 
* <br> 

* <br> 

* The other members of the component model correlator rely on this 

* format and it cannot 

* be changed. 

* 

* @param fcrList - the list of FCRs to be syntactically compared against the CCR 
* @param currentCCR - the candidate CCR for which correlation is desired 

* @return a double dimension array containing the FEV names and 

* corresponding scores. 

* 

* @author LT Steve Shedd 

* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KK KK KK */ 
public Object[] [] runSyntacticSearch( List fcerList, CCR currentCCR ) 
{ 


// Create a temporary data structure to hold search results 
List tempResults = new ArrayList (); 


// Variables used for the CCR-FCR comparison matrix 


float rowMax = 0; 
float matrix2normScore = 0; 
float fcrPercentageScore = 0; 
float fcrAttribCount = 0; 
float rowAttribMatchingThreshold = 0. 8f; 
boolean isOneToOne = true; 


// Get the list of CCR discriminator vectors 
List ccrVectors = currentCCR.getCCRSyntax().getDiscriminatorVectors(); 


// Get an iterator for the list of FEVs passed into the 
// Syntactic Correlator from the Semantic Correlator 
Iterator fcrIter = fcrList.iterator(); 


// Iterate through the list of FEVs. For each FEV FCR, perform a 

// a forward pass of each CCR discriminator vector through the FCR's 
// trained neural network. Tally the score using the CCR-FCR 

// comparison matrix variables. 

while ( fcrIter.hasNext() ) 

{ 








// Reset the CCR-FCR Comparison Matrix variables 
matrix2normScore = 0; 

fcrPercentageScore = 0; 

fcrAttribCount = 0; 


// Get the next FCR to test 
FCR testFCR = ( FCR )fcriIter.next (); 


// Get the trained neural network for the test FCR 
Neural fcrNeuralNet = testFCR.getFCRSyntax().getNeuralNetwork () ; 


// Create and initializ a boolean tracking array the size of the number 
// of outputs of the neural net. Since the number of output nodes 

// is equal to the number of FCR attributes, we can identify 

// which attribute corresponds to the row max of one entry in the 

// comparison matrix. When the attribute is identified, we can 

// set the corresponding attribTracker value to true. If the 

// attrib tracker contains any false entries at the end, we know 

// a one-to-one correspondence has not been achieved. 

boolean[] hasAttribMatch = new boolean[ fcrNeuralNet.NumOutputs ]; 


for ( int i = 0; i < hasAttribMatch.length; i++ ) 


{ 
hasAttribMatch[i] = false; 


} 
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// Get an iterator for the CCR discriminator vector list 
Iterator ccrVectorIter = ccrVectors.iterator(); 


while ( ccrVectorIter.hasNext () ) 


{ 


// Reset the row maximum variable 
rowMax = 0; 


// Create a local variable to track which attribute 
// has the row max. 
int attrib = -1; 


// Set the input vector for the forward pass 
fcrNeuralNet.Inputs = ( float[] ) ccrVectorIter.next (); 


// Perform the forward pass. This method uses the input vector 
// set in the previous line. 
fcrNeuralNet .ForwardPass (); 


// Cycle through the neural net output 
// vector and determine the row Maximum 
for ( int j = 0; j < fcrNeuralNet.OutputLayer_Out.length; jt+ ) 
{ 
float val = fcrNeuralNet.OutputLayer_Out[j]; 


if ( rowMax < val ) 
{ 


rowMax = val; 


if ( rowMax > rowAttribMatchingThreshold ) 
{ 

attrib = j; 
} 


// Set the attribTracker element that matches the FCR 
// attribute to true. 
if ( attrib !=-1 ) 


hasAttribMatch[attrib] = true; 


// Add the square of the row max to the running tally of 
// the matrix score. 
matrix2normScore += ( float )Math.pow( ( double )rowMax, 2 ); 


} 


// Complete the calculation of the 2-Norm for the 
// CCR-FCR comparison matrix 
matrix2normScore = ( float )Math.sqrt( ( double )matrix2normScore ); 


// Compute a percentage score for the FCR being tested. 
fcorPercentageScore = ( float )( matrix2normScore * 100 / 2.0 ); 


// Determine if the CCR-FCR comparison is one-to-one 
for ( int k = 0; k < hasAttribMatch.length; k++ ) 
{ 
if ( !hasAttribMatch[k] == false ) 
{ 
isOneToOne = false; 
break; 


} 


// If the correspondence is one-to-one, add the results to the 
// syntacticResults double dimention array. 
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+ + * + F F + F FH HF 


// The following schema is used for the array: 
// index 0: FEV Name 

// index 1: FCR Score 

if ( isOneToOne ) 


// Create a single FEV/Score pair 

Object [] singleResult = new Object [2]; 

singleResult[0] = new String( testFCR.getFEV().getFEVName() ); 
singleResult [1] = new Float( fcrPercentageScore ); 


// Add the pair to the temporary results list 
tempResults.add( singleResult ); 


// If there are results, convert the temporary list into 
// a double dimension object array. 
if ( tempResults.size() > 0 


// Size the results double dimension array 
syntacticResults = new Object[ tempResults.size() ] [2]; 


// Create an counter to place items in the final results 
int fev = 0; 


Iterator tempResultsIter = tempResults.iterator(); 


while ( tempResultsIter.hasNext() ) 
{ 


// Copy the single result pair into the syntacticResults Array 


Object [] fevScorePair = ( Object [] ) tempResultsIter.next (); 
syntacticResults[fev] [0] = fevScorePair[0]; 
syntacticResults[fev] [1] = fevScorePair[1]; 


} 





// Order the results according to score 
mergeSort ( syntacticResults, 0, syntacticResults.length - 1 ); 


} 

else 

{ 
// Tf there are no results, then create a single entery in the array 
// and return it. 
syntacticResults = null; 


} 


//ceturn syntacticResults; 
return syntacticResults; 


// End runSyntacticSearch 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


<br> 

Implementation of of the merge-sort algorithm for the double 
dimension array used 

to store the FEV/score pairs. The first column in the array must 
contain the names 

of the FEVs and the second column must contain the scores as 
floats. This is an 

optimal sorting algorithm which executes in O(n lg n ) in the 
worst case scenario. 


* 


@param A —- a double dimension array containing the FEV/Score 


160 


* results to be sorted 

* @param indexLo - The start index of the array 
* @param indexHi - The end index of the array 

* 

* @author LT Steve Shedd 

* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK */ 
private void mergeSort( Object[] [] A, int indexLo, int indexHi ) 


{ 


int lo indexLo; 
int hi = indexHi; 


if ( lo >= hi ) 
{ 
return; 


} 


// Determine the value of mid. 
// int mid = (lo + hi) / 2; 


// Determine the value of mid in double form. 
Double dmid = new Double( Math.floor( ( lo + hi) / 2) ); 


// Get mid as an integer value 
int mid = dmid.intValue(); 


//Partition the list into two lists and sort them recursively 
mergeSort( A, lo, mid ); 
mergeSort( A, mid +1, hi ); 


//Merge the two sorted lists 
int end_lo = mid; 
int start_hi = mid + 1; 


while ( ( lo <= end_lo ) && ( start_hi <= hi ) ) 
{ 
if ( ( ( Float )A[lo] [1] ).floatValue() < 
( ( Float )A[start_hi] [1] ).floatValue() ) 
{ 
lott; 
} 
else 
{ 
/* 


* allo] >= al[start_hi] 
The next element comes from the second list, 
move the a[start_hi] element into the next 

* position and shuffle all the other elements up. 


*/- 
Object[] temp = A[start_hi]; 
for ( int k = start_hi - 1; k >= lo; k-—- ) 


{ 
A[k + 1] 


A(k]; 
} 

A[lo] = temp; 

lott; 


end_lott+; 
start_hit++; 


} // End mergeSort 
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} // End SyntacticSearchEngine 


E. PACKAGE: mil.navy.nps.cs.babel.Correlator 
i Be Class CMCorrelatorAdaptor 


J [RK KR KKK KK RI A I KKK A ee IAA AA A ee AAA AA A Ae ee IAA A A A ee He oe 


// Filename:............. CMCorrelatorAdaptor. java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

of) BOEROT? . Sasa ea ae Cee LT Steve Shedd, USN and LT George Lawler, USN 

[PIC OMP AMY 5 8 ca cesack aresecbinre ere Naval Postgraduate School, Monterey, California 

| AD hot ere ee eee Eee eee ee September 2002 


J [BKK RK KK KKK A KKK ee AAA AA ee AAA A Ae ee IIA A A A A He He He He 


package mil.navy.nps.cs.babel.Correlator; 


import mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface; 
import javax.swing.JComponent; 


import org. jdom.Document; 


public class CMCorrelatorAdaptor implements CMCorrelatorInterface 


{ 


public CMCorrelatorAdaptor () 
{ 
} 


public void updateCCRList () 
{ 


[** KKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
* method 


KKKKKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK */ 


throw new java.lang.UnsupportedOperationException( "Method updateCCRList() not yet 
implemented." ); 


} 


public JComponent getCorrelatorPanel () 


{ 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KKK KK KK KK KKK KK 


*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
method 


KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK */ 
throw new java.lang.UnsupportedOperationException( "Method getCorrelatorPanel() not 
yet implemented." ); 


} 


public void generateCCRSemanticComponents( Document paramJDOMDoc ) 


{ 


[** KKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KK KK KKK 


*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
method 
FOU WIE RICK RK RK EERE KERR EREREKREERRERARREREEKRKER EEK E RR ERK RRK RRR CREEK EE REKREKE */ 
throw new java.lang.UnsupportedOperationException( "Method 
generateCCRSemanticComponents() not yet implemented." ); 


} 


public void generateCCRSyntacticComponents( Document paramJDOMDoc ) 


{ 


[** KKK KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK 
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*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
method 
KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK */ 
throw new java.lang.UnsupportedOperationException( "Method 
generateCCRSyntacticComponents() not yet implemented." ); 


} 


public void generateFCRSemanticComponents( Document paramJDOMDoc ) 
{ 
[** KKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KK KK KKK KKK KK KKK KK KKK 
*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
method 
KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK */ 
throw new java.lang.UnsupportedOperationException( "Method 
generateFCRSemanticComponents() not yet implemented." ); 


} 


public void generateFCRSyntacticComponents( Document paramJDOMDoc 
{ 
[** KKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK KKK KKK KKK KKK KKK 
*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
method 
KKEKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KEKE */ 
throw new java.lang.UnsupportedOperationException( "Method 
generateFCRSyntacticComponents() not yet implemented." ); 


} 


public void doSyntacticCorrelation () 
{ 
[** KK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKKKKKKKKEK 
*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
method 
KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKKKKK */ 
throw new java.lang.UnsupportedOperationException( "Method doSyntacticCorrelation () 
not yet implemented." ); 


} 


public void doSemanticCorrelation () 
{ 
[** KKK KKK KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK 
*@todo: Implement this mil.navy.nps.cs.babel.connectors.CMCorrelatorInterface 
method 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 
throw new java.lang.UnsupportedOperationException( "Method doSemanticCorrelation () 
not yet implemented." ); 


} 


} //end CMCorrelatorAdapter 
Z; Class ComponentModelCorrelator 
J [RRR RK KKK KK A KKK A A ee AAA AA A ee IAA AA A ee IAA A A A He He He oe 
// Filename:............. ComponentModelCorrelator. java 
// Parent PPOWS CEG oc octersecierse SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 
// Original Compiler:....Sun JDK 1.3.1_04 
foe UE OL to od 5 ok 5 catheter eae oo LT Steve Shedd, USN and LT George Lawler, USN 
/-/ Wompany + o194:0'.194.s sees Naval Postgraduate School, Monterey, California 
7 ap DY Aol eee nce eee eee ee er September 2002 
bP INOR OS cia i ti dia ie £e8 ae This class was originally created by LT George Lawler 


// who is currently the master developer for the overall OOMI IDE user interface. 
J [BR KR RK KK KK KKK KK KKK A A KKK RA A AA A ee RRA AAA A ee IAA A A A He He He oe 


package mil.navy.nps.cs.babel.Correlator; 
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import javax.swing.JComponent; 

import javax.swing.JTable; 

import javax.swing.table.DefaultTableModel; 

import java.util.List; 

import java.util.Iterator; 

import java.util.ArrayList; 

import java.util.Hashtable; 

import mil.navy.nps.cs.babel.Correlator.CMCorrelatorAdaptor; 

import org. jdom.Document; 

import mil.navy.nps.cs.babel.event.CorrelatorPanelEvent; 

import mil.navy.nps.cs.babel.event.CorrelatorPanelEventListener; 
import javax.swing.event.EventListenerList; 

import mil.navy.nps.cs.babel.event.CurrentSelectionChangeListener; 
import mil.navy.nps.cs.babel.event.CurrentSelectionChangeEvent; 
import mil.navy.nps.cs.babel.connectors.OOMIDisplayInterface; 

import mil.navy.nps.cs.babel.constructionManager.FIOMConstructionManager; 
import mil.navy.nps.cs.babel.connectors.FIOMDBDirectInterface; 

import mil.navy.nps.cs.babel.data.FIOMDatabase; 

import mil.navy.nps.cs.babel.Correlator.semanticComponentGenerator.*; 
import mil.navy.nps.cs.babel.Correlator.semanticSearchEngine.*; 
import mil.navy.nps.cs.babel.Correlator.syntacticComponentGenerator.*; 
import mil.navy.nps.cs.babel.Correlator.syntacticSearchEngine.*; 
import mwa.ai.neural.*; 





/[** KKK KKK KK KK KKK KKK KKK KKK KK KKK KKK KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KK KKK KKK 


* 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


<br> 
The <i>ComponentModelCorrelator</i> is th 
Model Correlator module of the OOMI IDE. 
<br><br> 

<ul> 
<at> 
Eas ie 


Generation of semantic correlation c 
Generation of syntactic correlation 


<li> Semantic correlation 
<li> Syntactic correlation 
</ul> 


<br> 


@author LT Steve Shedd, LT George Lawler 
@version 1.0 


KKEKKKKKKKKKK KKK KKK KKK KK KK KKK KK KK KK KK KK KK KO 


e overall executive of the Component 
This class coordinates the following: 


omponents 
components 


KKK KKK KK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKK 


af 


public class ComponentModelCorrelator extends CMCorrelatorAdaptor implements 
CorrelatorPanelEventListener, CurrentSelectionChangeListener 


{ 


private CorrelatorPanel cmCorrelatorPanel 


protected static FIOMDBDirectInterface 


private EventListenerList listenerList 


private OOMIDisplayInterface handleForGUI 


// Results data structures 
private ArrayList semanticResultsFCRLis 








private Object[] [] 


handleForFIOMDB 


filteredSemanticResults 


null; 


null; 


new EventListenerList (); 


null; 


new ArrayList (); 


null; 
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private Object[] [] filteredSyntacticResults = null; 
private Object[] [] filteredCombinedResults = null; 


// Correlator Properties and Preferences 
private int semanticThreshold = 70; 


private int syntacticThreshold = 70; 


private int combinedThreshold = 70; 





private float nueralLearningRate = 0.25f; 





private int neuralMaxEpochs = 100000; 





private double neuralOutputErrorTolerance = 0.1; 


public ComponentModelCorrelator( OOMIDisplayInterface paramGUI ) 
{ 


// Reference to the OOMI IDE display interface which can be used to send 
// status messages to the GUI. 
handleForGUI = paramGUI; 





//Singleton on the data base, only one FIOMDatabase 
handleForFIOMDB = FIOMDatabase.getDatabase(); 
handleForFIOMDB.addCurrentSelectionChangeListener( this ); 


cmCorrelatorPanel = new CorrelatorPanel( this ); 


} //end constructor 


//This class will handle all events from the displayed Correlator. So 
// button actions get redirected here. 


/* These legacy methods represent the functionality that must be captured 
by the event listener model in use by the correlator panel. The 
methods used to use parameters, so the event object will have to 
carry as payload the values that used to be parameters. 


public void correlatorPreferencesButtonPressed(); 

public void correlatorKeywordsButtonPressed (Object paramThreshold) ; 
public void correlatorNeuralNetButtonPressed (Object paramThreshold) ; 
public void correlatorCombinedButtonPressed (Object paramThreshold) ; 


public void correlatorShowSelectedFE () ; 


aA 


[** KKK KK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKK KKK KKK K 
* 
* 


* @author LT George Lawler, USN 
* 


KKKKK KKK KKK KKK KKK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKK KKK KKK KKK KKK KKK KK */ 


public void panelEventOccured( CorrelatorPanelEvent event ) 


{ 
//System.out.printin("something happened atleast"); 
//System.out.printin(event.getEventID()); 


switch ( event.getEventID() ) 
{ 
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case CorrelatorPanelEvent .PREFERENCES_BUTTON_PRESSED 
//System.out.println("Set preferences"); 
break; 

case CorrelatorPanelEvent .KEYWORD_BUTTON_PRESSED 
System.out.printlin("Redirecting KEYWORD_BUTTON event to 


doSemanticCorrelation()"); 
doSemanticCorrelation(); 
break; 


case CorrelatorPanelEvent .NEURAL_NET_BUTTON_PRESSED 
doSyntacticCorrelation(); 
break; 
case CorrelatorPanelEvent .COMBINED_BUTTON_PRESSED : 
// Not sure if we still want to keep this in here 
// the comnbined button maybe should go away as well. 
break; 
case CorrelatorPanelEvent .SHOW_FEV_BUTTON_PRESSED : 
// Show selected FEV to the Register Tab Panel. 
break; 
case CorrelatorPanelEvent .CCR_SELECTED 
this.handleForFIOMDB.setCurrentCCR ( 








(String) ((CorrelatorPanel) event.getSource()) .ccrSelected.getSelectedItem() ); 
break; 
default : 
System.out.printin( "Default envoked" ); 
break; 
} 
} //end panelEventOccured 


/[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* This method forces the correlator panel to get the latest 
* Unregisterd CCR list. 
KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEKE */ 
public void updateCCRList () 
{ 
this.cmCorrelatorPanel.setCCRList ( this.handleForFIOMDB.getCCRList ()); 
} 


/** Just returns the correlator panel that is held in this class */ 
public JComponent getCorrelatorPanel () 
{ 
return ( ( JComponent )this.cmCorrelatorPanel ); 
} //end getCorrelatorPanel 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 
* <br> 
Creates the semantic components for a CCR needed for the semantic correlation. 


* @param ccrJdomDoc - a JDOM Document representation of the CCRs 
XML Schema file. 
@return None 


@author LT Steve Shedd 
@version 1.0, September 2002 


+ * HF 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKKKK */ 


public void generateCCRSemanticComponents( Document ccrJdomDoc ) 


{ 


// Create a temporary data structure 
String[] keywords = null; 


// Get an instance of a keyword generator 
KeywordGenerator semanticGen = new KeywordGeneratorImpl (); 
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try 
{ 
// Get the keywords for the CCR 
keywords = semanticGen.generateKeywords( ccrJdomDoc ); 


} 


catch ( Exception e ) 


{ 


e.printStackTrace(); 


} 


// Associate the keywords to the CCRSemantics component 
this.handleForFIOMDB.getCurrentCCR().getCCRSemantics().setKeywordList ( keywords )j; 


System.out.print ("\n" + handleForFIOMDB.getCurrentCCR().getCCRName() + " Keywords: 


for ( int i = 0; i < keywords.length; i++ ) 
{ 
System.out.print ( keywords[i] + " "); 


} 
System.out.println(); 


// Send a status message back to the OOMI IDE 
this.handleForGUI.setStatusBarText ( "CCR Semantic Components Generated" ); 


} //end generateCCRSemanticComponents 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKKKKKKKKKK KKK KKK KKK KK KKK 


* <br> 
Creates the syntactic components for a CCR needed for the 
syntactic correlation. 


@param ccrJdJdomDoc - a JDOM Document representation of the CCRs 
XML Schema file. 
@return None 


@author LT Steve Shedd 
@version 1.0, September 2002 


+ + + + + + F F HF OF 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KEKE */ 


public void generateCCRSyntacticComponents( Document ccrJdomDoc ) 


{ 


// Create an instance of the Discriminator Generator 
DiscriminatorGenerator gen = new DiscriminatorGeneratorImpl (); 


// Create a list for the discriminator vectors 
List discr = null; 


try 
{ 
// vun the generator 
discr = gen.generateDiscriminatorVectors( ccrJdomDoc ); 


} 


catch ( Exception e ) 


{ 


e.printStackTrace(); 


} 


// Associate the discriminator vectors with the CCRSyntax component 
handleForFIOMDB.getCurrentCCR().getCCRSyntax().setDiscriminatorVectors( discr ); 


Iterator vectors = discr.iterator(); 


int i = 0; 
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System. out.printin("\n\n-----------— "+ handleForFIOMDB.getCurrentCCR() .getCCRName () 


while ( vectors.hasNext() ) { 
float[] local = (float[])vectors.next(); 
System.out.print ("\nnorm" + (++i) + ": "); 


for ( int j = 0; j < local.length ; j++ ) { 


System.out.print( local[j] + " "); 


// Send a status message back to the GUI 
this.handleForGUI.setStatusBarText ( "CCR Syntactic Components Generated" ); 


} //end generateCCRSyntacticComponents 


[** KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KK KKK KKKK KKK KKK 
* <br> 

* Creates the semantic components for an FCR needed for the 
* semantic correlation. 
* 
* 


@param fcrdJdomDoc - a JDOM Document representation of the FCRs 
XML Schema file. 
@return None 


@author LT Steve Shedd 
@version 1.0, September 2002 


KKKK KKK KKK KK KKK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 
public void generateFCRSemanticComponents( Document fcrJdomDoc ) 


{ 


// Create a temporary data structure 
String[] keywords = null; 


// Get an instance of a keyword generator 
KeywordGenerator semanticGen = new KeywordGeneratorImpl () ; 


try 
{ 
// Get the keywords for the FCR 
keywords = semanticGen.generateKeywords( fcrJdomDoc ); 
} 
catch ( Exception e ) 
{ 
e.printStackTrace(); 


} 


// Associate the keywords to the FCRSemantics component 
this.handleForFIOMDB.getCurrentFCR().getFCRSemantics().setKeywordList ( keywords ); 


System.out.print ("\n" + handleForFIOMDB.getCurrentFCR().getFCRName() + " Keywords: 


for ( int i = 0; i < keywords.length; i++ ) 
{ 
System.out.print( keywords[i] + " "); 
} 
System.out.println(); 


// Send a status message back to the OOMI IDE 
this.handleForGUI.setStatusBarText ( "FCR Semantic Components Generated" ); 
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} //end generateFCRSemanticComponents 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KK KKK KKK 
* <br> 

Creates the syntactic components for an FCR needed for the 

syntactic correlation. 


@param fcrJdomDoc - a JDOM Document representation of the FCRs 
XML Schema file. 
@return None 


@author LT Steve Shedd 
@version 1.0, September 2002 


+ + + + + + F F HF OF 


KKKK KKK KKK KKK KKK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK */ 
public void generateFCRSyntacticComponents( Document fcrJdomDoc ) 


{ 


// Create an instance of the Discriminator Generator 
DiscriminatorGenerator gen = new DiscriminatorGeneratorImpl (); 


// Create a list for the discriminator vectors 
List discr = null; 


try 
{ 
// run the discriminator generator 
discr = gen.generateDiscriminatorVectors( fcrJdomDoc ); 
} 
catch ( Exception e ) 
{ 
e.printStackTrace(); 


} 


// Associate the discriminator vectors with the CCRSyntax component 
handleForFIOMDB.getCurrentFCR().getFCRSyntax().setDiscriminatorVectors( discr ); 


Iterator vectors = discr.iterator(); 


int i = 0; 
System.out.printlin("\n\n-----------— "+ handleForFIOMDB.getCurrentFCR() .getFCRName () 
an sk fet i gh sgl sa a mye 
while ( vectors.hasNext() ) { 
float[] local = (float[])vectors.next(); 
System.out.print ("\nnorm" + (++i) + ": "); 


for ( int j = 0; j < local.length ; jt+ ) { 


System.out.print( local[j] + " "); 


} 


// Create an instance of the neural net generator 
NeuralNetGenerator nnGen = new NeuralNetGeneratorImpl (); 


// Create and train a neural network for the FCR 
Neural nn = nnGen.generateNeuralNet( discr ); 


// Set the path for the neural network file 
String path = "c:\\root\\etc\\babel\\generated\\neural \\"; 
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path = path + handleForFIOMDB.getCurrentFCR() .getFCRName () ; 


// Create and save a formated neural network file 
nnGen.makeFile( nn, path ); 


// Associate the syntactic components with the FCRSyntax component 
handleForFIOMDB.getCurrentFCR().getFCRSyntax().setDiscriminatorVectors( discr ); 
handleForFIOMDB.getCurrentFCR() .getFCRSyntax().setNeuralNetwork( nn ); 
handleForFIOMDB.getCurrentFCR().getFCRSyntax().setNNfilePath( path ); 


// Send a status message to the OOMI IDE 
this.handleForGUI.setStatusBarText ( "FCR Syntactic Components Generated" ); 


} //end generateFCRSyntacticComponents 


[** KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* <br> 

Implementation of the semantic correlation phase of the Component Model 
Correlator. This 

method performs the semantic correlation between a CCR and the 

list of FEV FCRs in 

the FIOM. It then sends the results of the correlation to the 

results component of 

the Correlator Panel in the OOMI IDE. 


@param None 
@return None 


@author LT Steve Shedd 
@version 1.0, September 2002 


+ + + FF * + FF F * FF 


KKKKKKKK KKK KKK KKK KK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public void doSemanticCorrelation () 


{ 


// Because the syntactic correlator depends on the results of the semantic 
// correlator, we null any previous syntactic results. 
this.filteredSyntacticResults = null; 

this.filteredSemanticResults null; 

this.filteredCombinedResults = null; 


// Create an instance of the semantic search engine 
SemanticSearchEngine semanticSearch = new SemanticSearchEngineImpl (); 


// Create a reference for the unfiltered search results 
Object[] [] unfilteredResults = null; 


// Get a list of all FCRs in the FIOM 
List localFIOMFCRList = this.handleForFIOMDB.getFCRList (); 


// Check to see if there are FCRs in the FIOM 

if ( localFIOMFCRList != null ) 

{ 
// Perform the semantic correlation. This will produce a sorted object 
// array of FCR names and Scores for every FCR in the FIOM 
unfilteredResults = semanticSearch.runSemanticSearch( localFIOMFCRList, 
handleForFIOMDB.getCurrentCCR()); 





} 


else 


{ 
this.handleForGUI.setStatusBarText ( "No FEVs in FIOM" ); 


} 


System.out.println("\n\nCurrent CCR is: " + 
handleForFIOMDB.getCurrentCCR().getCCRName () ) ; 

System.out.printin("Raw semantic results:\n"); 

for ( int i = 0; i < unfilteredResults.length; i++ ) 
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System.out.printin( unfilteredResults[i] [0] + ": " + unfilteredResults[i] [1] 


} 


// Filter by Threshold value. This will send any previous semantic 

// results to Java's Garbage collector. 

this.filteredSemanticResults = 

filterResultsByThreshold( unfilteredResults, this.semanticThreshold ); 


// Save the list of resulting FEV names to the semantic FEV Results list. 

// This step is necessary for two reasons. First, the results of the semantic 
// search are passed into the syntactic search. However, the double dimension 
// array semanticResults contains an FEV/Score pair for every FEV in the FIOM. 
// Therefore, it is necessary to create a new list of the just hte FEV names. 
// Second, the semanticResults array can be re-filtered dynamically by the 

// interoperability engineer within the correlator panel. Therefore, a list 

// of filtered results must be kept separate from the aggregate results. 

for ( int i= 0; i < this.filteredSemanticResults.length; i++ ) 





this.semanticResultsFCRList.add( this.filteredSemanticResults[ i] [ 0] ); 


System.out.printin("\nFiltered semantic results:\n"); 
for ( int i = 0; i < filteredSemanticResults.length; i++ ) 





System.out.printin( filteredSemanticResults[i] [0] + ": "+ 


filteredSemanticResults[i] [1] ); 


} 





System.out.println(); 


// The combined results simply equals the semantic results at this point because 
// the syntactic correlation has not taken place. 
this.filteredCombinedResults = this.filteredSemanticResults; 


// Send the results to the correlator panel display 
this.sendResultsToCorrelatorPanel( this.filteredSemanticResults, 
this.filteredSyntacticResults, 

this.filteredCombinedResults ); 


// Send a status message back to the OOMI IDE 
this. handleForGUI.setStatusBarText ( "Semantic Correlation Completed" ); 


// End doSemanticCorrelation 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKKK 


* 


+ + + + * HF FF FH * OK 


<br> 

Implementation of the syntactic correlation phase of the Component Model 
Correlator. This 

method performs the syntactic correlation between a CCR and the 

list of FEV FCRs in 

the FIOM. It then sends the results of the correlation to the 

results component of 

the Correlator Panel in the OOMI IDE. 


@param None 
@return None 


@author LT Steve Shedd 
@version 1.0, September 2002 


KKKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKK */ 


public void doSyntacticCorrelation () 


{ 


// Create an instance of the syntactic search engine 
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SyntacticSearchEngine syntacticSearch = new SyntacticSearchEnginelImpl (); 


// Create a reference for the unfiltered search results 
Object[] [] unfilteredResults = null; 


// Check to see if the semantic correlation returned some results 
if ( semanticResultsFCRList != null ) 
{ 
// Perform the semantic correlation. This will produce a sorted object 
// array of FCR names and Scores for every FCR in list populated from 
// the semantic correlation results 
unfilteredResults = syntacticSearch.runSyntacticSearch( semanticResultsFCRList, 
handleForFIOMDB.getCurrentCCR()); 





} 


else 


{ 


// Tf there are no results from the semantic correlator, do the syntactic 
// correlation with the FCR list from the entire FIOM. 


List localFIOMFCRList = this.handleForFIOMDB.getFCRList (); 


if ( localFIOMFCRList != null ) 

{ 
unfilteredResults = syntacticSearch.runSyntacticSearch( localFIOMFCRList, 
handleForFIOMDB.getCurrentCCR()); 

} 

else 

{ 
this.handleForGUI.setStatusBarText ( "No FEVs in FIOM" ); 


if ( unfilteredResults != null ) 
{ 


// Filter by Threshold value 
this.filteredSyntacticResults = filterResultsByThreshold( unfilteredResults, 
this.syntacticThreshold ); 





// The combined results equals the average of the semantic and syntactic 
scores. 
for ( int i = 0; i < this.filteredSemanticResults.length; i++ ) 
{ 
float sem = ( ( Float )this.filteredSemanticResults[ i] [ 1 ] 
).floatValue(); 
float syn = ( ( Float )this.filteredSyntacticResults[ i] [ 1 ] 
).floatValue(); 
float avg = ( sem + syn ) / 2; 
this.filteredCombinedResults[ i] [ 1 ] = new Float( avg ) ; 





} 


// Send the results to the correlator panel display 
this.sendResultsToCorrelatorPanel( this.filteredSemanticResults, 
this.filteredSyntacticResults, 

this.filteredCombinedResults ); 


} // End doSyntacticCorrelation 


[** KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KK KKK KKK 
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* Utility function to filter a list of FEV/Score pairs by 

* threshold value setting. 

* This function returns a new double dimension array. The array must 

* have an FEV name 

* in index 0 and an FEV correlation score as index 1 

* 

* @param input - double dimension array containing FEV/Score pairs. 

* @param threshold - The threshold setting for the particular correlation 
* @return A new double dimension array containing the FEV/Score pairs 

* above the threshold 

* 

* @author LT Steve Shedd 

* 

KKKK KKK KKK KKK KKK KKK KK KK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


private Object[] [] filterResultsByThreshold( Object[] [] input, int threshold ) 
{ 


// Create a new structure for the filtered output 
Object[] [] filteredOutput = null; 


// Create a temporary data structure for the FEV names 
ArrayList FEVNames = new ArrayList (); 


// Create a temporary data structure for the FEV scores 
ArrayList Scores = new ArrayList (); 





float floatThreshold = (float)threshold/100f; 


// Cycle through the input double dimension array and 
// copy pairs above the threshold. 
for ( int i = 0; i < input.length; i++ ) 
{ 
if ( ( ( Float )input[ i] [ 1 ] ).floatValue() >= floatThreshold ) 
{ 
FEVNames.add( i, input 


Feat J. oP Oe yy 
Scores.add( i, input[ i] [1] ); 
} 


// Size the filtered output double dimension array 
filteredOutput = new Object[ FEVNames.size() ] [ 2 ]; 


//Convert the FEVNames and Scores lists to a double dimension object array 
for ( int j = 0; j < FEVNames.size(); jtt+ ) 
{ 

// Copy the FEV Name 

filteredOutput[ j ] [ 0 ] = new String((String)FEVNames.get( j )); 


// Copy the associated FEV Score 
filteredOutput[ j ] [ 1 ] = new Float (((Float)Scores.get( j )).floatValue()); 
} 


return filteredOutput; 


} // End filterResultsByThreshold 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
* <br> 

* Formats the FEV/Score pairs produced by the semantic and syntactic 

* correlators for the 

* Correlator Panel. The Correlator Panel uses a JTable to display the 

* correlation results. 

* The defaultTableModel for a JTable can be used to convert a double 

* dimension array into 

* a JTable. This method merges the three input double dimension arrays 
* into a single double 

* dimension array. The JTable in the correlator panel is then populated 
* with the results. 
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The pairs in the input array must have an FEV name in index 0 and 
the FEV score in 
index 1. 


@param semanticResults - the filtered results of the semantic correlation 
@param syntacticResults - the filtered results of the syntactic correlation. 
@param combinedResults - the filtered combined correlation results. 


* 
* 
* @author LT Steve Shedd 
* 
* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KEEK 
private void sendResultsToCorrelatorPanel( Object[] [] semanticResults, 
Object [] [] syntacticResults, Object[] [] combinedResults 
{ 


// Create a new array for the table data. Size the array with 

// the length of the semantic results since the semantic results 
// are passed on to the syntactic correlator. 

Object[] [] tableData = new Object[ semanticResults.length ] [ 6 J]; 








for ( int i = 0; i < semanticResults.length; i++ ) 


{ 


tableData[ i] [ 0 ] = semanticResults[ i] [ 0 ]; 
tableData[ i] [ 1 ] = semanticResults[ i] [ 1 ]; 
tableData[ i] [ 2 ] = "Pass-through"; 
if ( syntacticResults == null ) 
{ 

tableData[ i] [ 3 ] = null; 
} 
else 
{ 

tableData[ i] [ 3 ] = syntacticResults[ i] [1]; 
} 
tableData[ i] [ 4 ] = combinedResults[ i] [1]; 
tableData[ i] [ 5 ] = "FE Name"; 


} 


// Create defealt Table model with the table data array. 
this.cmCorrelatorPanel.setContent( tableData ); 


// Remains to be implemented 


// The correlator panel works with the CCR list, and so it must 
// know when the current CCR is changed, this listener method 
// will be called when ever the CurrentCCR is changed in the 
// FIOMDatabase class. 
public void selectionChanged( CurrentSelectionChangeEvent event ) 
{ 
if ( event.getSelectionThatChanged() == 
CurrentSelectionChangeEvent .CCR_SELECTION_CHANGED ) 
{ 
//Update the CCR list in the correlator panel 
this.updateCCRList (); 
} 
else 
{ 
// no action for Current FCR change event 
} 
} //end selectionChanged 
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// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


pa 


im 
im 
im 
im 


im 
im 
im 
im 
im 
im 
im 


// 


/* 


* 
* 
* 
* 
* 
* 
* 
* 
* 


* 


//end ComponentModelCorrelator 


3. Class CorrelatorPanel 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KK KK KK KK KK 
Filename:............. ComponentModelCorrelator. java 
Parent Project:....... OOMI IDE 
Original Compiler:....Sun JDK 1.3.1_04 
PIPED OE tee Sa eal LT George Lawler, USN 
POMD ay facratracearar aces Naval Postgraduate School, Monterey, California 
DEES e £62 act eee g a eke ete September 2002 
NOUES? oe ata esdle wes This class was originally created by LT George Lawler 


during the development of the OOMI IDE prior to the completion of the features 


of the Component Model Correlator. 
KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KK KK KK KKK KK KK KKK KKK KK KK KK KK KK kK KK KK KK KK 
ckage mil.navy.nps.cs.babel.Correlator; 
port java.awt.*; 
port java.awt.event.ActionListener; 
port java.awt.event.ActionEvent; 
port javax.swing.*; 


port mil.navy.nps.cs.babel.event.CorrelatorPanelEvent; 
port mil.navy.nps.cs.babel.event.CorrelatorPanelEventListener; 
port javax.swing.event.EventListenerList; 


port javax.swing.JTable; 

port javax.swing.table.TableModel; 

port javax.swing.table.AbstractTableModel; 
port javax.swing.table.DefaultTableModel; 
import javax.swing.table.TableColumn; 








KKK KKK KKK KKK KKK KKK KK KK KK KK KK KKK KKK KKK KKK KKKKKKKKKKKKKKK KKK KK KK KKK KKKKKKKKKKKKKKKEEEK 


Title: Babel Correlator Panel 


Description: Front end for Register Tab Panel connection to the Correlator. 
Also provides area for display of correlator results. 
Pass in the MainFrame parametere during construction so that 
this panel can access the controlChannel to pass events to the 
back end. 

@author LT George Lawler 


KKK KKKKKKKKKKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK KK */ 


public class CorrelatorPanel extends JPanel 


{ 


//This reference allows access to the controlChannel, which is of 
// type OOMIControlInterface, in this case. 
//private MainFrame parentFrame = null; 


private JPanel contentPane = null; 


[** KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KK KKK KKK KK 


* The table used to display the results of the component model 
* correlation phases. 
KKK KKK KKK KK KK KKK KKK KKK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK */ 


JTable table = null; 


[** KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKKKKKKK 
* The title for the first column in the table displayed on this panel. 

* This title is built into a TableModel that is used to construct the 

* table. 


KKKKK KKK KK KKK KK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 
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public static String COLUMN_ZERO_TITLE = new String( "FEV" ); 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KK KKK KKK 


* The title for the second column in the table displayed on this panel. 
* This title is built into a TableModel that is used to construct the 
* table. 


KKKK KKK KKK KK KK KK KKK KK KK KK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK */ 


public static String COLUMN_ONE_TITLE = new String( "Keyword Score" ); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KK KK KK KK 
* The title for the third column in the table displayed on this panel. 
* This title is built into a TableModel that is used to construct the 
* table. 


KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKEEK */ 


public static String COLUMN_TWO_TITLE = new String( "Pass-Thru" ); 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
* The title for the fourth column in the table displayed on this panel. 

* This title is built into a TableModel that is used to construct the 

* table. 


KKK KKK KKK KKK KK KK KKK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KK */ 


public static String COLUMN_THREE_TITLE = new String( "Neural Net Score" ); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKEK 
* The title for the fifth column in the table displayed on this panel. 

* This title is built into a TableModel that is used to construct the 

* table. 


KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKK */ 


public static String COLUMN_FOUR_TITLE = new String( "Combined Score" ); 





/[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* The title for the sixth column in the table displayed on this panel. 
* This title is built into a TableModel that is used to construct the 
* table. 


KKKKKK KKK KKK KKK KK KK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK */ 


public static String COLUMN_FIVE_TITLE = new String( "Select FE" ); 
// ** This next section is indented to show which parts are 'contained' 
Lf in which of the overal panel's sub containers. 


//This control area panel holds all the widgets 
JPanel controlArea = new JPanel(); 


JPanel ccrSelectionSubPanel = new JPanel (); 
JLabel ccrSelectionLabel = new JLabel(); 
JComboBox ccrSelected = new JComboBox() ; 


Button preferencesButton = new JButton(); 


q 


JPanel thresholdSubPanel = new JPanel(); 


ey 


Label buttonLabel = new JLabel(); 


JButton filterOnKeyword = new JButton(); 





Button filterOnNeuralNet = new JButton(); 


q 


JButton filterOnCombined = new JButton(); 


JLabel comboBoxLabel = new JLabel(); 
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JComboBox keywordThreshold = null; //new JComboBox (() ; 
JComboBox neuralNetThreshold = null; //new JComboBox () ; 
JComboBox combinedScoreThreshold = null; //new JComboBox(); 
JPanel actionSubPanel = new JPanel (); 

JButton showSelectedFE = new JButton(); 


private Insets buttonInsets = new Insets( 2, //top 
2 //left 
2 //bottom 
2 )5 //cight 


//This data area panel holds the table that shows the resluts 
JScrollPane dataArea = null; 


//This was the first way I made the table. Its not very efficient 
//TableColumn fevColumn = new TableColumn(); 

//TableColumn keywordScoreColumn = new TableColumn () ; 
//TableColumn passThruOptionColumn = new TableColumn () ; 
//TableColumn neuralNetScoreColumn = new TableColumn(); 
//TableColumn combinedScoreColumn = new TableColumn () 


//TableColumn selectFEColumn = new TableColumn () ; 


, 


//This is how many choices to put in the Threshold drop down arrays 
private static int NUMBER_OF_VALUES = 10; 





//This is the distance between thresholds. Increment is 

// multiplied by the index plus one (plus one so the first 
// value isn't zero). NUMBER_OF_VALUES times the INCREMENT 
// is the maximum value in the table. 

private static int INCREMENT = 10; 


// so that the value shown is 70 
private static int DEFAULT_THRESHOLD_INDEX = 6; 


//this Object array holds strings that represent the 
// integer value for the search threshold 
private Object[] thresholdValues = null; 


private EventListenerList listenerList = new EventListenerList (); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKK KK KKK KKK KKK KK 


* Constructor calls the private init method to set up the 

panel, and catches any exceptions encountered during panel 

setup. 

@param MainFrame reference used to gain access to the OOMIControlInterface 


Pass in to this object a CCR List and an FCR list so that the panel 
will come up with a few things in it for the demo. 


Hold off on constructing this panel until the FIOM is created, so that 


there will be values available to pass as parameters. 
KKK KKK KKK KK KKK KKK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


+ + + 4 4 H HH 


public CorrelatorPanel( CorrelatorPanelEventListener paramEventListener ) 


{ 
//parentFrame = paramParent; 


try 
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init (5 

this.contentPane = this; 
this.addCorrelatorPanelEventListener( paramEventListener ); 
catch ( Exception e ) 


e.printStackTrace(); 





} //end CorrelatorPanel constructor 


public void addCorrelatorPanelEventListener( CorrelatorPanelEventListener 
listener ) 


{ 


this.listenerList.add( CorrelatorPanelEventListener.class, listener ); 


public void removeCorrelatorPanelEventListener( CorrelatorPanelEventListener 
listener ) 


{ 


this.listenerList.remove( CorrelatorPanelEventListener.class, listener ); 





public void fireCorrelatorPanelEvent( int eventID, int threshold, 
String selectedName ) 
{ 


//CCR[] ccrList = this.fiom.getUnregisteredCCR(); 
//Object[] nameArray = new Object [ccrList.length]; 


//for(int i=0; i < ccrList.length; i++) 

//{ 

// nameArray[i] = new String( ccrList[i].getCCRName() ); 
//System.out.println(ccrList [i] .getCCRName () ); 

//}//end for loop 


//Guaranteed to return a non-null array 
Object[] listeners = this.listenerList.getListenerList (); 
// Process the listeners last to first, notifying 
// those that are interested in this event 
for ( int i = listeners.length —- 2; i >= 0; i -=2 ) 
{ 
CorrelatorPanelEvent event = null; 
if ( listeners[i] == CorrelatorPanelEventListener.class ) 
{ 
// lazily create the event: 
if ( event == null ) 
{ 
event = new CorrelatorPanelEvent( this, 
eventID, 
threshold, 
selectedName ); 
} 
( ( CorrelatorPanelEventListener )listeners[i+l]) .panelEventOccured (event) ; 
} 
} // end of for loop to notify listeners 
} //end fireCorrelatorPanelEvent () 


private void init () 


{ 


this.setLayout ( new BorderLayout() ); 
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this.controlArea.setLayout ( new FlowLayout() ); 


this.initCCRSelector(); 
//this.ccrSelectionSubPanel.setLayout (new GridLayout (2,1)); 
//this.ccrSelectionLabel.setText ("Compoenent Class Selected:"); 
//this.ccrSelectionSubPanel.add(this.ccrSelectionLabel) ; 
//this.ccrSelectionSubPanel.add(this.ccrSelected) ; 


this.preferencesButton.setText( "Preferences" ); 
this.preferencesButton.setMargin( buttonInsets ); 
this.preferencesButton.setEnabled( true ); 
this.preferencesButton.addActionListener ( 
new ActionListener () 
{ 

public void actionPerformed( ActionEvent e ) 

{ 

preferencesButton_actionPerformed( e ); 

} 

} ); 


this.filterOnCombined.setText( "Combined Score" ); 
this.filterOnCombined.setMargin( buttonInsets ); 
this.filterOnCombined.setEnabled( true ); 
this. filterOnCombined.addActionListener ( 
new ActionListener () 
{ 
public void actionPerformed( ActionEvent e ) 
{ 
filterUsingCombined_actionPerformed( e ); 
} 
} )3 


this.filterOnKeyword.setText ( "Keywords" ); 
this.filterOnKeyword.setMargin( buttonInsets ); 
this.filterOnKeyword.setEnabled( true ); 
this.filterOnKeyword.addActionListener ( 
new ActionListener () 
{ 
public void actionPerformed( ActionEvent e ) 
{ 
filterUsingKeywords_actionPerformed( e ); 
} 
} ); 


this.filterOnNeuralNet.setText( "Neural Net" ); 
this.filterOnNeuralNet.setMargin( buttonInsets ); 
this.filterOnNeuralNet.setEnabled( true ); 
this.filterOnNeuralNet.addActionListener ( 
new ActionListener () 
{ 
public void actionPerformed( ActionEvent e ) 
{ 
filterUsingNeuralNet_actionPerformed( e ); 
} 
} ); 


//get an array of proper length for Threahold values 
this.thresholdValues = new Object [NUMBER_OF_VALUES]; 


//fill the array with values based on INCREMENT 
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for ( int i = 0; i < NUMBER_OF_VALUES; i++ ) 
{ 
//1 add one to i, so that the first element is not zero. 
this.thresholdValues[i] = String.valueOf( ( i+ 1 ) * INCREMENT ); 
} 


//then just build the combo boxes out of the array from above 
this.keywordThreshold = new JComboBox( this.thresholdValues ); 
this.keywordThreshold.setSelectedIndex ( DEFAULT_THRESHOLD_INDEX ); 


this.combinedScoreThreshold = new JComboBox( this.thresholdValues ); 
this.combinedScoreThreshold.setSelectedIndex ( DEFAULT_THRESHOLD_INDEX ); 


this.neuralNetThreshold = new JComboBox( this.thresholdValues ); 
this.neuralNet Threshold. setSelectedIndex ( DEFAULT_THRESHOLD_INDEX ); 








this.buttonLabel.setText( new String( "Filter On:" ) ); 




















this.buttonLabel.setHorizontalAlignment ( JLabel.RIGHT ); 
this.comboBoxLabel.setText ( new String( "Threshold Values:" ) ); 
this.comboBoxLabel.setHorizontalAlignment ( JLabel.RIGHT ); 
// set up the threshold buttons and combo boxes 
this.thresholdSubPanel.setLayout ( new GridLayout( 2, 4 ) ); 
this.thresholdSubPanel.add( this.buttonLabel ); 
this.thresholdSubPanel.add( this.filterOnKeyword ); 
this.thresholdSubPanel.add( this.filterOnNeuralNet ); 
this.thresholdSubPanel.add( this.filterOnCombined ); 
this.thresholdSubPanel.add( this.comboBoxLabel ); 
this.thresholdSubPanel.add( this.keywordThreshold ); 
this.thresholdSubPanel.add( this.neuralNetThreshold ); 
this.thresholdSubPanel.add( this.combinedScoreThreshold ); 
this.showSelectedFE.setText( new String( "Show FE" ) ); 
this.showSelectedFE.setMargin( buttonInsets ); 
this.showSelectedFE.setEnabled( true ); 
this.showSelectedFE.addActionListener ( 

new ActionListener () 

{ 


public void actionPerformed( ActionEvent e ) 
{ 
showSelectedFE_actionPerformed( e ); 
} 
} ); 


this.actionSubPanel.add( this.showSelectedFE ); 


//put all the sub comonents into the controlArea 
this.controlArea.add( ccrSelectionSubPanel ) ; 
this.controlArea.add( this.preferencesButton ); 
this.controlArea.add( this.thresholdSubPanel ); 
this.controlArea.add( this.actionSubPanel ); 


/* This was my first approach. Much easier to just define the 
table model, as shown below. 

this.fevColumn.setHeaderValue (new String("FEV") ); 

this.keywordScoreColumn.setHeaderValue (new String("Keyword Score") ); 

this.passThruOptionColumn.setHeaderValue (new String("Pass-—Thru") ); 
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this.neuralNetScoreColumn.setHeaderValue (new String("Neural Net Score")); 
this.combinedScoreColumn.setHeaderValue (new String("Combined Score") ); 
this.selectFEColumn.setHeaderValue (new String("Select FE") ); 

i, 


//This sets up a table with 5 rows with the column headers found at 
// the start of this class. 
TableModel dataModel = new AbstractTableModel () 
{ 
public int getColumnCount() { return 6; } 


//This method is used to construct the table, and so 
// by returning the desired heading label, the table is 
// constructed each time to look as we desire. 
public String getColumnName( int columnIndex ) 
{ 
String columnName = null; 
switch ( columnIndex ) 
{ 
case( 0 ) 
columnName = CorrelatorPanel.COLUMN_ZERO_TITLE; 
break; 
case( 1): 
columnName = CorrelatorPanel.COLUMN_ONE_TITLE; 
break; 
case( 2) : 
columnName = CorrelatorPanel.COLUMN_TWO_TITLE; 
break; 
case( 3 ) 
columnName = CorrelatorPanel.COLUMN_THREE_TITLE; 
break; 
case( 4): 
columnName = CorrelatorPanel.COLUMN_FOUR_TITLE; 
break; 
case( 5) : 
columnName = CorrelatorPanel.COLUMN_FIVE_TITLE; 
break; 
default: 
columnName = new String( "error" ); 























} 


return ( columnName ); 


} 


public Class getColumnClass( int column ) 
{ 

Class classValue = null; 

switch ( column ) 


{ 


//case(2) : case(5) : classValue = (Class) 
javax.swing.JToggleButton.class; 
//oreak; 
default: 
classValue = ( Class ) java.lang.Object.class; 


} 


return ( classValue ); 


public int getRowCount() { return 5; } 


//eventually this will need to be writen to link the table that we 
// view, which is being defined here, to arrays of information that 
// are passed into the CorrelatorPanel from the correlator. 

// So that as the table is constructed, this statement can 

// veturn that which is to be displayed. 

// right now I'm trying to display a blank table with 

// checkboxes in the third and fifth columns. 

public Object getValueAt( int row, int col ) 
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Object cellValue = null; 
switch ( col ) 


{ 


//case(2) : case(5) : cellValue = new JCheckBox()j; 
Pep break; 
default: 

cellValue = new String( "" ); 


} 


return ( cellValue ); 
}; 
this.table = new JTable( dataModel ); 


//this.add(table, BorderLayout.CENTER) ; 
dataArea = new JScrollPane( table ); 


//put the control area and the data area in the main panel 
//this.add(this.controlArea, BorderLayout .NORTH) ; 
//this.add(this.dataArea, BorderLayout.CENTER) ; 
this.refreshCorrelatorPanel (); 


} //end init 


public void initCCRSelector () 
{ 
this.ccrSelected.addActionListener ( 
new ActionListener () 
{ 
public void actionPerformed( ActionEvent e ) 


{ 
changeToSelectedCCR( e ); 


this.ccrSelectionSubPanel = new JPanel (); 
this.ccrSelectionSubPanel.setLayout ( new GridLayout( 2, 1) ); 
this.ccrSelectionLabel.setText ( "Compoenent Class Selected:" ); 
this.ccrSelectionSubPanel.add( this.ccrSelectionLabel ); 
this.ccrSelectionSubPanel.add( this.ccrSelected ); 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 
* Most likely this will either accept a 2D array of 
* data that will be put in this panel's table for 
display. 
The alternative is to construct the table else 
where and send in the whole table. It seems better 
to just send in the data and let the panel 
handle the table details. 


odified on 9/21/2002 by LT Steve Shedd 


++ + + + ¥ FF FH F 


KKK KKK KKK KKK KKK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKKKKK */ 


public void setContent( Object[] [] tableContent ) 
{ 








String[] columnNames = { CorrelatorPanel.COLUMN_ZERO_TITLE, 
CorrelatorPanel.COLUMN_ONE_TITLE, 
CorrelatorPanel.COLUMN_TWO_TITLE, 
CorrelatorPanel.COLUMN_THREE_TITLE, 
CorrelatorPanel.COLUMN_FOUR_TITLE, 
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} 


CorrelatorPanel.COLUMN_FIVE_TITLE }; 
TableModel newModel = new DefaultTableModel( tableContent, columnNames ); 


this.table = null; 


this.table = new JTable( newModel ); 
this.dataArea = new JScrollPane( table ); 


this.refreshCorrelatorPanel (); 


//end setContent 


public void setCCRList( Object[] paramList ) 


{ 


} 


//Object[] tempList = this.parentFrame.controlChannel.getAvailableCCRList () ; 


//for(int i=0; i<tempList.length; i++) 


//{ 

ie this.ccrSelected.addItem( tempList[i] ); 

//}3 

this.ccrSelected.removeAllitems (); // = new JComboBox (); 


for ( int i = 0; i < paramList.length; i++ ) 
{ 
this.ccrSelected.addItem( paramList[i] ); 
//System.out.println(paramList[i]); 
} 


//this.initCCRSelector(); 
//System.out.printin(this.ccrSelected.getItemCount ()); 


refreshCorrelatorPanel (); 
//end setCCRList 


public void refreshCorrelatorPanel () 


{ 


this.removeA11 (); 


this.add( this.controlArea, BorderLayout.NORTH ); 
this.add( this.dataArea, BorderLayout.CENTER ); 


//this.contentPane = this; 


// KKEKKKKKKKKKKKKKK Button Handlers KKK KKK KKK KK KKK KKK KKK KKKKKKKKKKKK KKK KKK 


private void preferencesButton_actionPerformed( ActionEvent e ) 


{ 


} 


fireCorrelatorPanelEvent ( CorrelatorPanelEvent .PREFERENCES_BUTTON_PRESSED, 
CorrelatorPanelEvent.NULL_INT, 
CorrelatorPanelEvent.NULL_STRING ); 

//end preferencesButton_actionPerformed 





private void filterUsingKeywords_actionPerformed( ActionEvent e ) 


{ 


int threshold = Integer.parselInt ( 
( this. keywordThreshold.getSelectedItem() ).toString() ); 
fireCorrelatorPanelEvent ( CorrelatorPanelEvent .KEYWORD_BUTTON_PRESSED, 
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threshold, 
CorrelatorPanelEvent .NULL_STRING ); 
} //end filterUsingKeywords_actionPerformed 


private void filterUsingNeuralNet_actionPerformed( ActionEvent e ) 


{ 


int threshold = Integer.parseInt( ( this.neuralNetThreshold.getSelectedItem () 
} ,tostring({) )3 
fireCorrelatorPanelEvent ( CorrelatorPanelEvent .NEURAL_NET_BUTTON_PRESSED, 
threshold, 
CorrelatorPanelEvent.NULL_STRING ); 
} //end filterUsingNeuralNet_actionPerformed 


private void filterUsingCombined_actionPerformed( ActionEvent e ) 


{ 


int threshold = Integer.parseInt( ( this.combinedScoreThreshold.getSelectedItem () 
).toString() ); 
fireCorrelatorPanelEvent ( CorrelatorPanelEvent .COMBINED_BUTTON_PRESSED, 
threshold, 
CorrelatorPanelEvent.NULL_STRING ); 
} //end filterUsingCombined_actionPerformed 


private void showSelectedFE_actionPerformed( ActionEvent e ) 
{ 

try 

{ 


//this.parentFrame.controlChannel.correlatorShowSelectedFE () ; 


} 


catch ( java.lang.UnsupportedOperationException uoe ) 


{ 


//this.parentFrame.notImplementedDialog( uoe ); 


} 
} //end showSelectedFE_actionPerformed 


private void changeToSelectedCCR( ActionEvent e ) 


{ 
fireCorrelatorPanelEvent ( CorrelatorPanelEvent.CCR_SELECTED, 
CorrelatorPanelEvent.NULL_INT, 
( ( String )this.ccrSelected.getSelectedItem() ) ); 


public JPanel getCorrelatorPanel () 
{ 
return ( this.contentPane ); 


} 


} //end CorrelatorPanel 


F. PACKAGE: mil.navy.nps.cs.babel.connectors 
1. Interface CMCorrelatorInterface 
package mil.navy.nps.cs.babel.connectors; 


import java.util.*; 
import javax.swing.JComponent; 


import org. jdom.Document; 
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/** Document the purpose of this class. 


* 


* @version 1.0 
* @author 


*/ 


LT Steve Shedd 


public interface CMCorrelatorInterface 


{ 


public 


public 


publ 
publ 
publ 


publ 


ic 


aio, 


ic 


re 


public 


publ 





ie 


void updateCCRList (); 
JComponent getCorrelatorPanel (); 
void generateCCRSemanticComponents (Document paramJDOMDoc) ; 


void generateCCRSyntacticComponents (Document paramJDOMDoc) ; 





void generateFCRSemanticComponents (Document paramJDOMDoc) ; 
void generateFCRSyntacticComponents (Document paramJDOMDoc) ; 
void doSyntacticCorrelation(); 


void doSemanticCorrelation(); 


185 


THIS PAGE INTENTIONALLY LEFT BLANK 
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APPENDIX B. FIOM FRAMEWORK MODIFICATION SOURCE 


A. PACKAGE: mil.navy.nps.cs.oomi.fiom 


// 
// 
// 
// 
// 
// 
// 
// 
// 


1. Interface Semantics 


KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK 


Semantics.java 

SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 

Sun JDK 1.3.1_04 

LT Steve Shedd, USN 

Naval Postgraduate School, Monterey, California 

September 2002 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KK KKK KK KK KK KK KK KK KK KK KK KK 





package mil.navy.nps.cs.oomi.fiom; 


public interface Semantics 


{ 


// 
// 
// 
// 
// 
// 
// 
// 
// 


pa 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the Keyword list held by this FEV object 


* 


* @author Steve Shedd 


KK KK KK KK KK KKK KK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KKK KK KK KKK KKK KK */ 





public String[] getKeywordList (); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Sets a keyword list for an FEV object. 
* 


* @author Steve Shedd 


KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEKE */ 


public void setKeywordList (String[] in); 


Zs Interface Syntax 














KK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKKKKKEK 

Filename:............. Syntax. java 

Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 

Original Compiler:....Sun JDK 1.3.1_04 

AUGHOP Ss ..6c5 25 vias eee LT Steve Shedd, USN 

COMPANY? wiscea ce ecole Saee we lene Naval Postgraduate School, Monterey, California 

| BY — ee September 2002 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KK KK KKK KK KK KK KK KK KK 


ckage mil.navy.nps.cs.oomi.fiom; 


import java.util.List; 


public interface Syntax 


{ 


[** KKK KKK KKK KKK KKK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKK KKK KKK 


* Get the discriminator vectors for this FEV object 
* 


* @author Steve Shedd 


KKK KKK KK KK KK KKK KK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 
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public List getDiscriminatorVectors (); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Set discriminator vectors for this FEV object 
* 


* @author Steve Shedd 


KKK KK KK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK EK */ 


public void setDiscriminatorVectors (List in); 


3. Interface CCR 


J [KK RK KK KK Re KAA AA A ee AAA A A ee IAA AA A ee IIA A A A A ee oe oe 


// 
// 
// 
// 
// 
// 
// 
// 


Filename:............. CCR. java 

Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 

Original Compiler:....Sun JDK 1.3.1_04 

AUCH OT oes kere Sone. Sieger rar Lee Shong Cheng [Lee02] 

Modified By:.......... LT Steve Shedd, USN 

COMDENY ia sso o94 eee e464 Naval Postgraduate School, Monterey, California 

DISS a cog erdag. S25 foe ae ece ha September 2002 


J [BKK RK KK KKK A A I KKK AAA A ee IAA AAA A Ae ke AAA A A ee IA A A A A ee oe oe 


package mil.navy.nps.cs.oomi.fiom; 


import mil.navy.nps.cs.oomi.*; 
import mil.navy.nps.cs.oomi.fiom.*; 
import mil.navy.nps.cs.oomi.exceptions.*; 


[** KR KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK kk kk kK KK KK KK KK KK KK KK KKK 


+ + 


* 


+ + + F FF HH HH HH 


* 


Represents a CCR in OOMI. 
A CCR should be uniquely defined by: 
<ol> 
<li> SystemName and CCRName 
<li> SystemName and XMLNameSpaceURI 
</ol> 
within the FIOM. 
<p> 
Responsibilities: 
<ul> 
<li> Represents a CCR in the OOMI FIOM. 
<li> Maintain information on whether an attribute of its FCR is mandatory, 
based on the FCRtoCCR attribute mappings contained in this object. 
</ul> 


@author LSC 
@version 1.0 


KKK KKKKKKKK KKK KKK KKK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KK KK KK KKK KK KK KKK KOK */ 


public interface CCR 


{ 


/** Returns the name of this CCR. */ 
public String getCCRName () ; 


/** Returns the name of the system this CCR is defined for. */ 
public String getSystemName () ; 








/** Returns the FCR of this CCR. */ 
public FCR getFCR() ; 
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[** KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK 
* Joins this CCR to the specified FCR. 


* If bewFCR==null, nothing is done. 
* @param newFCR The FCR that this CCR will be joining. 


KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKK KKK KKK KK */ 


public void joinFCR( FCR newFCR ) ; 


/** Returns the CCRSchema for this object. */ 
public CCRSchema getCCRSchema () ; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Returns the fully-qualified Castor 

* generated Java class's (a descendent of CCRInstance) name for this CCR. 
* A String is used instead of Class so that it may be possible 

* to work with the CCR without actually loading the bytecode for the 


* Class. 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KK KK KK KK */ 


public String getJavaClassName () ; 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Sets the fully-qualified name of the Castor 


* generated Java class (a descendent of CCRInstance) for this CCR. 
KKKKKKK KKK KKK KK KK KK KK KK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK */ 


public void setJavaClassName( String javaClassName )j; 


/** Returns the XML Schema URI this CCR is defined for. */ 
public String getXMLNameSpaceURI (); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Sets the XML Schema URI this CCR is defined for. 


* A well-formed valid URI is expected, no error checking is performed. 
KKKKKK KKK KKK KKK KK KK KKK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKKKK KKK KKK KK KKK KK KKK */ 


public void setXMLNameSpaceURI( String xmlNameSpaceURI ); 


/[** KKK KK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KKK 


* The given FCR attribute is mandatory if it is mapped to one or more mandatory 
* CCR attributes. 


* 


KKKKKKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KK */ 


public boolean isMandatoryFCRAttribute( Attribute fcrAttr ); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Returns an array of mandatory attributes of the FCR this CCR is associated 
* with. 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKK KEKE */ 


public Attribute[] mandatoryFCRAttributes () ; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KK KKK 


* Returns the number of mandatory attributes of the FCR this CCR is associated 
* with. 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


public int mandatoryFCRAttributeCount (); 


/** Adds a mapping of FCR attributes to the attribute of this CCR object. */ 
public void addFCRToCCRAttributeMapping( Attribute[] from, Attribute to ); 


/** Clears the FCR to CCR attribute mappings. */ 
public void clearFCRToCCRAttributeMappings () ; 
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[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Get the CCR Semantics File 


* 


* @author Steve Shedd 


KKKKKK KKK KKK KKK KK KK KKK KK KK KK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public CCRSemantics getCCRSemantics (); 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Sets the semantics for this CCR. 
* 


* @author Steve Shedd 


KKKKKK KKK KKK KK KK KKK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK */ 


public void setCCRSemantics( CCRSemantics sem ); 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKKKKKKKKKKKKKKKK KK KKK K 


* Get the CCR Syntax File 


* 


* @author Steve Shedd 


KKKKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public CCRSyntax getCCRSyntax()j; 


[** KKEKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KK KK KK KK KK KK 


* Sets the syntax for this CCR. 


* 


* @author Steve Shedd 


KKKKK KKK KKK KKK KK KKK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK */ 


public void setCCRSyntax( CCRSyntax syn ); 


4. Interface CCRSemantics 


J [BRK KR KKK KKK I I KKK AAA A ee IAA AA A Ae ee AAA AA A ee IAA A A A He He oe oe 


// Frlename: . cccevaccs cae ss CCRSemantics. java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

flo BURR OE Ming wan oae eh SEN LT Steve Shedd, USN 

/:f Companyi.as..idasawawd Naval Postgraduate School, Monterey, California 

tf DACGY bie ae oe Ps September 2002 


J [BRR KK KK KK KR IKK A A ee IAA AA A ee IAA AA A Ae ee IAA A A Ae He oe oe 


package mil.navy.nps.cs.oomi.fiom; 


public interface CCRSemantics extends Semantics 


{ 


// Stubbed out for future extensions 


5; Interface CCRSyntax 


J [BRK RRR KKK KR KKK KKK KK I KKK KKK KKK KKK KKKKKKKKKKKKK KKK KK KK KK KK KKK KK KK KK KK KK KK KKK 


Pf BALONAMESs ¢66ec8 Bs ete Aners CCRSyntax. java 

// Parent PYOVCCES settee SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

Lif PCN OLS eevee itis SS ele ew LT Steve Shedd, USN 

[if “COMPANY S44 a ieenn wea eset Naval Postgraduate School, Monterey, California 

7 aan 9: ot ee ee ee eee ee ce ee September 2002 


J [BRR RK RRR KK KK KK KK KI A KK KR A AAA A KA AA A RRA AAA AAA A A A A A A A He 9 oe oe 
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package mil.navy.nps.cs.oomi.fiom; 


public interface CCRSyntax extends Syntax 


{ 


// Stubbed out for future extensions 


6. Interface FCR 


J [RRR RK KK KK Re KAA AA A Ae Ae AAA A A Ae ee AAA A A Ae ee IAA A A Ae He oe oe 


// 
// 
// 
// 
// 
// 
// 
// 


BU SM AME seus ene Serie eeu FCR. java 
Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 

Original Compiler:....Sun JDK 1.3.1_04 

PUICHORS eins cz dice teverie onetiaret Lee Shong Cheng [Lee02] 

OdTEACd) BY ecw cet ene LT Steve Shedd, USN 

POMDENY tha4 awa ara Naval Postgraduate School, Monterey, California 

DAES Seas ce cote Si6 nite sesdnesth v0 i0, Me September 2002 
J [BRR KR KK KK KK I I KKK AAA A ee AAA AA A Ae AAA A A ke ee IAA A A A He oe He oe 
package mil.navy.nps.cs.oomi.fiom; 





import java.net.URL; 


import mil.navy.nps.cs.oomi.*; 
import mil.navy.nps.cs.oomi.fiom.*; 
import mil.navy.nps.cs.oomi.exceptions.*; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK kk kk kK KK KK KK KK KKK KKK KKK 


* 


* 


@author LSC 
@version 1.0 


KR KKK KKK KKKKKKKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KKK KKK KK KOK */ 


public interface FCR 


{ 


/** Returns the name of this FCR. */ 
public String getFCRName() ; 


/** Returns the FEV of this FCR. */ 
public FEV getFEV(); 





/** Returns the number of CCRs defined for this FCR. */ 
public int ccrCount (); 


[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KK KKK KK 
* Returns all the CCRs defined for this FCR in an array. 


* @return Returns all the CCRs defined for this FCR in an array, 


* an empty array is returned if no CCRs defined. 
KKK KKK KK KKK KKK KK KKK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 


public CCR[] getCCR(); 


[** KKK KKK KKK KKK KK KKK KK KKK KK KKK KK KK KKK KK KK KK KK KKK KK KK KK KK KK KK KKK KKK KK KKK KK KK KKK KKK 


* Finds all the CCRs which satisifies the specified criteria. 


* @param criteria 
KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KK KKK KEK */ 


public void findCCR( SearchHandler handler ); 
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/[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KK KK 
* Finds all the CCR with for the specified system. 

* @param systemName 

* @return Returns all the CCRs in this FCR that belongs to the 

* specified system name 

: (not case-sensitive). 

* Returns an empty array if not found. 


KKKK KKK KKK KK KKK KK KK KK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKK KKK KKK KK KKK KKK KK */ 


public CCR[] findCCR( String systemName ); 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 
Finds the CCR with the specified name. 

* @param systemName 

* @param ccrName 

* @return Returns the CCR in this FCR that has the specified name 

> (not case-sensitive). 

i Returns null if not found. 


KKKKK KKK KKK KKK KK KKK KK KK KK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


public CCR findCCR( String systemName, String ccrName ); 


* 


[** KKKKKK KKK KKK KK KK KKK KK KK KK KK OK KK KK KK KK KK KK 
* Finds the CCR with the specified system name and xmlNameSpaceURI. 

* @param systemName 

* @param xmlNameSpaceURI 

* @return Returns the CCR in this FCR that has the specified system name 

* (not case-sensitive) and xmlNameSpaceURI. 

- Returns null if not found. 

“ xmlNameSpaceURI==null shall always result in a return value of null. 


KKK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


public CCR findCCR( String systemName, URL xmlNameSpaceURI ); 


/** Returns true if this FCR has a CCR with specified name. */ 
public boolean ccrExists( String systemName, String ccrName ); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


* Returns true if this FCR has a CCR with specified name. 
* @return Returns true if this FCR has a CCR with specified name. 


= Returns false if xmlNameSpaceURI==null. 
KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKK */ 





public boolean ccrExists( String systemName, URL xmlNameSpaceURI ); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 

* Creates a new instance of CCR for this FCR and returns the newly created 

instance. 

@param systemName The system name. 

@param ccrName The name of the new CCR. 

@param xmlNameSpaceURI The URL to the XML schema that the new CCR represents. 
Pass in null if XML schema is not required. 


@throws DuplicateKeyException When the specified systemName,ccrName pair or 
systemName, xmlNameSpaceURI pair 
already exist for this FCR. 
KKKKKK KKK KKK KKK KK KK KKK KK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 
public CCR newCCR( String systemName, String ccrName, URL xmlNameSpaceURI ) 
throws DuplicateKeyException; 





* 
* 
* 
* 
* 
* 
* 
* 
* 


/** Returns the FCRSchema for this object. */ 
public FCRSchema getFCRSchema () ; 


/** Returns the Java class name for this FCR. */ 
public String getJavaClassName() ; 
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// 
// 
// 
// 
// 
// 


/** Sets the Java class name for this FCR. */ 
public void setJavaClassName( String className ); 


[** KKK KKKKKKK KKK KKK KKK KKK KK KKK KK KK KK KK KKK KKK KKK KK KK KK KKK KK KK KK KK KKK KK KKK KKK KKK KKK 


* Finds the CCR that represents the specified XML schema. 
* A case-sensitive comparison is performed. 
* @param xmlNameSpaceURI The URL to the XML schema whose corresponding CCR 
is to be found. 
@return Returns the CCR that represents the specified XML schema 
corresponding to this FCR. 
* Returns null if no such CCR exists or if xmlNameSpaceURI==null. 


KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKK */ 


// public CCR findCCR( URL xmlNameSpaceURI ); 


4 + ¥ 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Get the FCR Semantics File 
* 


* @author Steve Shedd 


KKKK KKK KKK KK KKK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KK */ 


public FCRSemantics getFCRSemantics (); 


[** KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Sets the semantics for this FCR. 
* 


* @author Steve Shedd 


KKKKK KKK KKK KKK KK KKK KK KK KK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public void setFCRSemantics( FCRSemantics sem ); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKKKKKKKKK 


* Get the FCR Syntax File 


* 


* @author Steve Shedd 


KKKKK KKK KKK KK KKK KKK KK KK KK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK */ 


public FCRSyntax getFCRSyntax(); 


/[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK 


* Sets the syntax for this FCR. 


* 


* @author Steve Shedd 


KKK KKK KKK KKK KKK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 


public void setFCRSyntax( FCRSyntax syn ); 


as Interface FCRSemantics 
J [KKK KKK KKK KK KK KK A A I A A A KKK A AAA Ae AAA AA A A AA KAA AA A He He He 
Pilenates.40 44 dud aaa ¥ FCRSemantics. java 
Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 
Original Compiler:....Sun JDK 1.3.1_04 
AUCH OP Ss: Jicvaudie bes a4. 088 LT Steve Shedd, USN 
COMP AIS sce iwiaad xletene alee Naval Postgraduate School, Monterey, California 
DBCS es hig: ae: Sg a ec aes September 2002 


// 


J [BRK KR KKK KK KA KKK KA AA A ee IRR RA AA AAA A Ae A A A AAA A AA A He He He oe 


package mil.navy.nps.cs.oomi.fiom; 


public interface FCRSemantics extends Semantics 


{ 


193 


// Stubbed out for future additions 


8. Interface FCRSyntax 


J [BKK KKK KK KK I A KKK AAA A ee AAA AA A AAA A ee IA A A A A ee He e 


/f BPULLENAMES oss os: eee ended otek FCRSyntax. java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

Ff BUEN OP esl Las pe ee etn LT Steve Shedd, USN 

/- if COMPARY Sic 305 in Vd ah ae Naval Postgraduate School, Monterey, California 

/f Datei nis aes tate ea ee September 2002 


J [BRR RR KKK KK KA I I I KKK A A A ee AAA AA A ee AAA AA A eee IAA A A A He oe oe oe 


package mil.navy.nps.cs.oomi.fiom; 


import mil.navy.nps.cs.oomi.fiom.*; 
import mwa.ai.neural.*; 


public interface FCRSyntax extends Syntax 
{ 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Get neural network for this FCR. 
* 


* @author Steve Shedd 


KKKK KKK KKK KKK KKK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public Neural getNeuralNetwork (); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KK KKK KKK 


* Get neural network for this FCR. 
* 


* @author Steve Shedd 


KKK KKK KK KK KK KK KK KKK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public void setNeuralNetwork( Neural netIn ); 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


* Get the path to the neural network file for this FCR. 


* 


* @author Steve Shedd 


KKKKK KKK KK KK KKK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK */ 


public String getNNfilePath(); 


[** KKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK 


* Set the path for the neural network file for this FCR. 


* 


* @author Steve Shedd 


KKEKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK KK KK KK KK KK KK kK */ 


public void setNNfilePath( String absolutePath ); 


B. PACKAGE: mil.navy.nps.cs.oomi.impl 


1, Class SemanticsImpl 
J [BRR KKK KK KK RI I KKK AA A ee AAA AA A ee IAA AA A ee IAA A A A ee oe oe 
// Filename:............. SemanticsImpl. java 
// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 
// Oviginal Compiler:....Sun JDK 1.3.1_04 
ep RUN O BR ee ah oe Oe ae s6-4 LT Steve Shedd, USN 
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// (Company *-si+ia lbs Naval Postgraduate School, Monterey, California 
Y YoR Dae ice. dd Soe ane aocuste anoatene September 2002 


J [BRK RR KK KK KK I KAKA AA A ee AAA AA A kee AAA AA A Ae ee IAA A A A He He He oe 


package mil.navy.nps.cs.oomi.impl; 


import java.io.Serializable; 
import mil.navy.nps.cs.oomi.fiom.Semantics; 


public abstract class SemanticsImpl implements Semantics, Serializable 


{ 
protected final static int MAX_KEYWORD_LIST_SIZE = 10000; 


protected String[] keywordList = new String [MAX_KEYWORD_LIST_SIZE]; 


public SemanticsImpl () 
{ 


} 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 


* Get the Keyword list held by this semantics object 


* 


* @author Steve Shedd 
KKK KK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 
public String[] getKeywordList () 
{ 
return keywordList; 


} 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 


* Set the keyword list for an FEV object. 


* 


* @author Steve Shedd 
KKREKRREREKERK EKER EREREKR EKER RREKR RARE RRERERRRKEREREERER RE RRR RERRREEKRR KR ERERKRKRREREREE */ 
public void setKeywordList (String[] in) 
{ 
if ( in.length > 10000 ) 
{ 
for ( int i = 0; i < keywordList.length; i++ ) 
{ 
keywordList [i] = in[il]; 
} 
} 
else 


{ 


keywordList = in; 


2. Class SyntaxImpl 


J [BRK KR KKK KKK i IKK A Ae IAA AAA ee AAA A ke ee IAA A A A ee oe oe 


Lf FLLSN AME see ie CSA Sisk SyntaxImpl.java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

[of PUCROL Suis won ialndscrtis oi 28 LT Steve Shedd, USN 

//* Company P..%-.- oes cee eee Naval Postgraduate School, Monterey, California 
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Tbe 


pac 


imp 
imp 
imp 
imp 


pub 
{ 


Lp* 
// 
// 
// 
// 
// 
// 
// 
// 
LL* 


pac 
imp 


imp 
imp 


DERE eos base as ge eS September 2002 


KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KKK KK KK KKK KK 


kage mil.navy.nps.cs.oomi.impl; 


ort java.io.Serializable; 

ort java.util.List; 

ort java.util.ArrayList; 

ort mil.navy.nps.cs.oomi.fiom.Syntax; 


lic abstract class SyntaxImpl implements Syntax, Serializable 
List _discriminatorVectors = new ArrayList (); 


public SyntaxImpl () 
{ 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Get the discriminator vectors for this FEV object 
* 


* @author Steve Shedd 


KKK KKK KK KK KK KKK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KK */ 
public List getDiscriminatorVectors () 


{ 


return _discriminatorVectors; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Set discriminator vectors to this FEV object 
* 


* @author Steve Shedd 


KREKKKKKKKKKKKKKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKK KKK KKK */ 


public void setDiscriminatorVectors( List in ) 


{ 


_discriminatorVectors.addAll( in ); 


3. Class CCRImpl 


KKK KKK KKK KKK KK KKK KK KK KK KK KK KK KK 
Filename:............. CCRImpl. java 
Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 
Original Compiler:....Sun JDK 1.3.1_04 
AUCH OR Sis soso ch en Branton Bitetrerterse Lee Shong Cheng [Lee02] 
Odd Faved: BY eee eee LT Steve Shedd, USN 
COMDATY fa a5 Swe sae and Naval Postgraduate School, Monterey, California 
DSESS cyan ao ee oooh oe September 2002 
KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KK KK KK KKK KKK KK KKK KK KK KK KK KK KK KK KK KKK 
kage mil.navy.nps.cs.oomi.impl; 





ort java.util.*; 


ort mil.navy.nps.cs.oomi.*; 
ort mil.navy.nps.cs.oomi.fiom.*; 


import mil.navy.nps.cs.oomi.impl.*; 
import mil.navy.nps.cs.oomi.exceptions.*; 
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/[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KK KKK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK 


* A reference implementation of the Component Class Representation (CCR). 
* Needs to maintain the mandatory attributes of the corresponding FCR. 


* @author LSC 


* @version 1.0 
KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKEK */ 


public class CCRImpl implements CCR, Comparable 
{ 


/** FCR to CCR attribute mappings. */ 


protected List _fcrToCcrAttrMappingList = new ArrayList (); 


/** The system name of this CCR. */ 
protected String _systemName = ""; 


/** The name of this CCR. */ 
protected String _ccrName = ""; 


/** The FCR corresponding to this CCR. */ 
protected FCR _fcr = null; 





/** The schema for this CCR. */ 
protected CCRSchema _ccrSchema = new CCRSchemalImpl () ; 





[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* The semantics for this CCR. 
* 


* @author Steve Shedd 


KKK KKK KKK KKK KKK KKK KKKKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK */ 


protected CCRSemantics _ccrSemantics = new CCRSemanticsImpl (); 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KK KK KKK 


* The syntax for this CCR. 


* 


* @author Steve Shedd 


KREKKKKKKKKK KKK KKK KKK KKK KK KK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKK KKK */ 


protected CCRSyntax _ccrSyntax = new CCRSyntaxImpl (); 


/** The fully qualified name of the Castor generated class for the XML schema. */ 
protected String _javaClassName = ""; 


/** The URL to the XML schema for which this CCR is defined for. */ 
protected String _xmlNameSpaceURI = ""; 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKK KKK KKK KKK KKK KK 


* An array of mandatory FCR attributes. 


* Transient field, built from _fcrToCcrAttrMappingList when required. 
KKKKKK KKK KKK KKK KK KK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


protected Set _mandatoryFCRAttributes = new HashSet (); 


/** Constructor required by Castor Unmarshaller. */ 
public CCRImpl1 () 

{ 

} 
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[** KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Initializes the CCR. 


* If the specified FCR is not null, this CCR shall join the specified FCR. 
* @param fcr The FCR this CCR will join. 

* @param systemName System name of this CCR. 

* @param ccrName Name of this CCR. 


KKKKK KKK KKK KKK KKK KK KKK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK */ 


public CCRImpl( FCR fcr, String systemName, String ccrName ) 


{ 
joinFCR( fcr ); 
setCCRName( ccrName ); 
setSystemName( systemName ); 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 


* Sets the name of this CCR. 


* Public access required by Castor Unmarshaller. 
KKKKKKK KKK KKK KKK KKK KKK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK */ 


public void setCCRName( String ccrName ) 
{ 


_ccrName = ccrName; 


public String getCCRName () 
{ 


return _ccrName; 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Sets the FCR of this object. 


* Used only for Castor Marshaling/Unmarshaling. 
KKK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


void setFCR( FCR fcr ) 
{ 


_fer = fer; 


public FCR getFCR() 
{ 


return _fcr; 


public void joinFCR( FCR newFCR ) 


{ 
if ( newFCR != null ) 


{ 
( ( FCRImpl ) newFCR ).addCCR( this ); 


public CCRSchema getCCRSchema () 


return _ccrSchema; 


/** Public access required by Castor Unmarshaller. */ 
public void setCCRSchema( CCRSchema v ) 


{ 


_ccrSchema = vj; 
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[** KR KKK KKKKKKK KKK KKK KKK KKK KK KKK KKK KKK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKK KKK KKK 


* Gets the semantics for this CCR. 
* 


* @author Steve Shedd 

KKKKKKK KKK KKK KK KK KK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 
public CCRSemantics getCCRSemantics () 
{ 


return _ccrSemantics; 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Sets the semantics for this CCR. 
* 


* @author Steve Shedd 


KKK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK K */ 
public void setCCRSemantics( CCRSemantics sem ) 


{ 


_ccrSemantics = sem; 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK 


* Gets the syntax for this CCR. 


* 


* @author Steve Shedd 


KKKKK KKK KKK KKK KKK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK */ 


public CCRSyntax getCCRSyntax () 
{ 


return _ccrSyntax; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KOK 


* Sets the syntax for this CCR. 


* 


* @author Steve Shedd 


KKKK KK KKK KKK KKK KK KK KK KK KK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK */ 


public void setCCRSyntax( CCRSyntax syn ) 
{ 


_ccersyntax = syn; 


public String getJavaClassName () 
{ 


return _javaClassName; 


public void setJavaClassName( String javaClassName ) 
{ 


_javaClassName = javaClassName; 


public String getXMLNameSpaceURI () 
{ 


return _xmlNameSpaceURI; 


public void setXMLNameSpaceURI( String xmlNameSpaceURI ) 
{ 
_xmlNameSpaceURI = xmlNameSpaceURI; 
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public String getSystemName () 
{ 
return _systemName; 


} 


public void setSystemName( String v ) 
{ 
_systemName = v; 


} 


public AttributeMapping[] getFCRToCCRAttributeMapping () 

{ 
return ( AttributeMapping[] ) _fcrToCcrAttrMappingList.toArray ( 
new AttributeMapping[_fcrToCcrAttrMappingList.size()] ); 


public void setFCRToCCRAttributeMapping( AttributeMapping[] v ) 
{ 
clearFCRIoCCRAttributeMappings (); 
for ( int i = 0; i < v.length; i++ ) 
{ 
_fcrToCcrAttrMappingList.add( v[il]l ); 
} 


public Attribute[] mandatoryFCRAttributes () 

{ 
return ( Attribute[] ) mandatoryFCRAttributeSet () .toArray ( 
new Attribute [mandatoryFCRAttributeCount ()] ); 


public boolean isMandatoryFCRAttribute( Attribute fcrAttr ) 
{ 

return mandatoryFCRAttributeSet ().contains( fcrAttr ); 
i 


public int mandatoryFCRAttributeCount () 
{ 

return mandatoryFCRAttributeSet ().size(); 
} 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Returns the mandatory FCR attributes set, builds the set by calling 
* {@link #buildMandatoryFCRAttributeSet()} if the set is empty. 
KKKK KKK KKK KK KK KK KKK KK KK KK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK KK */ 
protected Set mandatoryFCRAttributeSet () 
{ 
if ( _mandatoryFCRAttributes.size() == ) 
{ buildMandatoryFCRAtt ributeSet (); } 
return _mandatoryFCRAttributes; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Builds the mandatory FCR attributes set, based on the current 
* _fcrToCcrAttrMappingList. 
KKK KKK KKK KKK KKK KK KK KK KK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKK */ 
protected void buildMandatoryFCRAttributeSet () 
{ 
// first, clear the existing set 
_mandatoryFCRAttributes.clear(); 
CCRSchema ccrSchema = getCCRSchema () ; 
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Iterator iter = _fcrToCcrAttrMappingList.iterator(); 
while ( iter.hasNext() ) 
{ 


AttributeMapping mapping = ( AttributeMapping )iter.next(); 
Attribute[] fcrAttrs = mapping.fromAttributes (); 
Attribute ccrAttr = mapping.toAttribute(); 


if ( ccrSchema.findAttribute( ccrAttr ).isMandatory() ) 
{ 
for ( int i = 0; i < fcrAttrs.length; i++ ) 
{ 
_mandatoryFCRAttributes.add( fcrAttrs[i] ); 
} 


public void addFCRToCCRAttributeMapping( Attribute[] from, Attribute to ) 

{ 
AttributeMapping mapping = FactoryImpl.factory().makeAttributeMapping( from, to ); 
_fcrToCcrAttrMappingList.add( mapping ); 


public void clearFCRToCCRAttributeMappings () 
{ 

_fcrToCcrAttrMappingList.clear(); 
} 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* Used mainly for sorting required during testing. 

* Ordering is based on SystemName order followed by CCRName. 

KKKKKKK KKK KKK KKK KKK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KK */ 
public int compareTo( Object o ) 
{ 


CCR ccr = ( CCR ) oO; 

if ( this == ) 

{ return 0; } 

Ent, .e¢ 

c = getSystemName().compareTo( ccr.getSystemName() ); 

if (c !=0 ) 

{ return c; } 

else { return getCCRName().compareTo( ccr.getCCRName() ); } 


static void p( String m ) 
{ 

System.out.println( m ); 
} 


4. Class CCRSemantics Impl 


J [BRK KR KK KK KR A A I KKK A A Ae AAA A A ee AAA A A Ae ee IAA A A A He He He He 


// Filename:............. CCRSemanticsImpl. java 

// Parent POPESCU tac. eraser SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

[of BUEN OR © i eisia eialG ot sts aheoie os LT Steve Shedd, USN 

fof COMPANY 4'4.5.4000 5: arate Sianet bie Naval Postgraduate School, Monterey, California 

t]e WAC iy ese cate eee eis es September 2002 


J [RRR RRR KKK KKK KK KK KH KKKKKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKK KKK KKK 


package mil.navy.nps.cs.oomi.impl; 


import mil.navy.nps.cs.oomi.fiom.CCRSemantics; 
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public class CCRSemanticsImpl extends SemanticsImpl implements CCRSemantics 


{ 


public CCRSemanticsImpl () 
{ 


super (); 


} 


ae Class CCRSyntaxImpl 


J [BRR KR KKK KK KI A I KKK AAR A ee IAA AAA A Ae ee AAA AA A Ae ee IAA A A A He He oe Oe 


// Filename:............. CCRSyntaxImpl. java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

Pf BUCH OTe. ice Wine Bio eee ese LT Steve Shedd, USN 

[of COMPANY 35 Anarni cers ata eee eee Naval Postgraduate School, Monterey, California 

Pf DAC 5 an sue, ecere te Tecaca ocd foe September 2002 


J [BRK RR KKK KK KI I KKK AR A Ae ee IA AAA A ee AAA AA A Ae ee IAA A A A He He oe oe 


package mil.navy.nps.cs.oomi.impl; 
import mil.navy.nps.cs.oomi.fiom.CCRSyntax; 
public class CCRSyntaxImpl extends SyntaxImpl implements CCRSyntax 
{ 
public CCRSyntaxImpl () 
{ 


super (); 


} 


6. Class FCRImpl 


J [BRK KR KK KK KK I KKK A AA Ae ee AAA A ee AAA A Ae IIIA A A A A He He He oe 


1 A fede 5 af 100 =e eee FCRImpl.java 

// Parent PLOY OCU ec veectwectek SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Oviginal Compiler:....Sun JDK 1.3.1_04 

(Ay cae NSW) oe) spec et ee ee Lee Shong Cheng [Lee02] 

// Modified By:.......... LT Steve Shedd, USN 

ff Company. 0-Sa waa Naval Postgraduate School, Monterey, California 

Fifer MA CPs: Sigs Bigs Shee Ses GA eotet te De September 2002 

J [RRR RK KK KK RA A KAA AA A ee IAA AA A ee AAA A A A ee IAA A A A ee oe oe 
package mil.navy.nps.cs.oomi.impl; 








import java.util.ArrayList; 
import java.util.Iterator; 
import java.util.List; 

import java.util.Set; 

import java.util.HashSet; 
import java.util.Arrays; 
import java.util.Collections; 
import java.util.Collection; 
import java.net.URL; 

import mil.navy.nps.cs.oomi.*; 
import mil.navy.nps.cs.oomi.fiom.*; 
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import mil.navy.nps.cs.oomi.impl.*; 
import mil.navy.nps.cs.oomi.exceptions.*; 


[** KKK KKK KKK KKK KKK KKK KKK KK KK KKK KK KK KK KK KK kk kk kk kkk KK KKK KK KK KK KKK KKK 


@author LSC 


* @version 1.0 
KKK K KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKEKK */ 


public class FCRImpl implements FCR 


/** The name of this FCR. */ 
protected String _fcrName = ""; 


/** The Java class name that implements the FCRInstance for this FCR. */ 
protected String _javaClassName; 


/** The FEV that corresponds to this FCR. */ 
protected FEV _fev = null; 


/** The list of CCRs corresponding to this FCR. */ 
protected Set _ccrSet = new HashSet (); 





/** The schema for this FCR. */ 
protected FCRSchema _fcrSchema = new FCRSchemalImpl (); 





[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KK KK KKK 
* 


[The semantics for this FCR. 
* 


* @author Steve Shedd 


KKK KKK KKK KKK KK KK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK */ 





protected FCRSemantics _fcrSemantics = new FCRSemanticsImpl (); 


[** KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKK 


* The syntax for this FCR. 


* 


* @author Steve Shedd 


KKK KK KKK KKK KKK KKK KKKKKKKKKK KKK KK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK */ 


protected FCRSyntax _fcrSyntax = new FCRSyntaxImpl (); 


/** Required for Castor Marshaller and Unmarshaller. */ 
public FCRImp1 () 
{ 


/** Creates a new instance with specified name. */ 
public FCRImpl( FEV fev, String fcrName ) 
{ 


setFCRName( fcrName ); 
setFEV( fev ); 


public String getFCRName () 
{ 


return _fcrName; 
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[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 

* Sets the name of this FCR. 

* To be used only by the constructor 

* and during restoration from persistent storage, using 

* Castor Unmarshaller. 

KKKKK KKK KK KK KK KK KKK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 
public void setFCRName( String fcrName ) 

{ 

_fcrName = fcrName; 


} 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 
* Sets the FEV of this FCR. 
* To be used only by the constructor 


* and by Castor Unmarshaller during restoration from persistent storage. 


* 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KK */ 
public void setFEV( FEV value ) 
_fev = value; 


} 


public CCR[] getCCR() 
{ 

return ( CCR[] ) _ccrSet.toArray( new CCR[ccrCount()] ); 
} 


public FEV getFEV() 
{ 
return _fev; 


} 


public int ccrCount () 
{ 
return _ccrSet.size(); 


} 


public void findCCR( SearchHandler handler ) 
{ 
terator iter = _ccrSet.iterator(); 
CCR ccr; 

while ( iter.hasNext() ) 


cer = ( CCR )iter.next(); 
if ( handler.satisfied( ccr ) ) 
{ handler.add( ccr ); } 





public CCR[] findCCR( String systemName ) 
{ 
java.util.HashSet result = new java.util.HashSet (); 
findCCR( makeCCRSystemNameSearchHandler( systemName, result ) ); 


return ( CCR[] ) result.toArray( new CCR[result.size()] ); 
/* 
List result = new ArrayList (); 
Iterator iter = _ccrList.iterator(); 
CCR ccr; 
while (iter.hasNext()) { 
ccr = (CCR)iter.next (); 
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if ( ccr.getSystemName() .equalsIgnoreCase(systemName) ) 
result.add(ccr); 
} 
return (CCR[]) result.toArray (new CCR[result.size()]); 
re 
} 


public CCR findCCR( String systemName, String ccrName ) 
{ 
Iterator iter = _ccrSet.iterator(); 
CCR: ccr; 
while ( iter.hasNext() ) 
{ 
cer = ( CCR )iter.next(); 
if ( ccr.getSystemName().equalsIgnoreCase( systemName ) && 
ccr.getCCRName() .equalsIgnoreCase( ccrName ) ) 
{ Yeturn cer?) 
} 


return null; 


public CCR findCCR( String systemName, URL xmlNameSpaceURI ) 
{ 


if ( xmlNameSpaceURI == null ) 

{ return null; } 

Iterator iter = _ccrSet.iterator(); 
CGR ‘ecr: 


String urlString = xmlNameSpaceURI.toString(); 
while ( iter.hasNext() ) 
{ 
ccr = ( CCR )iter.next(); 
if ( ccr.getSystemName().equalsIgnoreCase( systemName ) && 
ccr.getXMLNameSpaceURI () .equals( urlString ) 
{ return ccr; } 
} 


return null; 


/* 
public CCR findCCR( URL xmlNameSpaceURI ) { 
if (xmlNameSpaceURI==null) 
return null; 


Iterator iter = _ccrList.iterator(); 
CCR ccr; 
String urlString = xmlNameSpaceURI.toString(); 
while (iter.hasNext()) { 
cer = (CCR)iter.next (); 


if ( ccr.getXMLNameSpaceURI ().equals(urlString) ) 
return ccr; 
} 
return null; 
} 
+i 
public boolean ccrExists( String systemName, String ccrName ) 
{ 
return findCCR( systemName, ccrName ) != null; 


} 


public boolean ccrExists( String systemName, URL xmlNameSpaceURI ) 
{ 


return findCCR( systemName, xmlNameSpaceURI ) != null; 


public CCR newCCR( String systemName, String ccrName, URL xmlNameSpaceURI ) 
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throws DuplicateKeyException 


{ 


if ( ccrExists( systemName, ccrName ) ) 


throw new DuplicateKeyException( ccrName + 
"already exists for system: " + systemName ); 


if ( ccrExists( systemName, xmlNameSpaceURI ) ) 


throw new DuplicateKeyException( xmlNameSpaceURI + 
"already exists for system: " + systemName ); 


CCRImpl ccr = new CCRImpl( this, systemName, ccrName ); 
if ( xmlNameSpaceURI != null ) 

ccr.setXMLNameSpaceURI( xmlNameSpaceURI.toString() ); } 
_ccrSet.add( ccr ); 

return ccr; 





[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKKKKKKKKKK KKK KK KKK KKK 
* Adds the specified CCR object to this FCR, 

* <strong> the FCR field of the CCRImpl parameter is updated to 

* point to this object. </strong> 


* <p>Also used by Castor Unmarshaller only. 
* 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKKKKKKKKKKKKKKKK KK KKK */ 


public void addCCR( CCR newCCR ) 


{ 
( ( CCRImpl )newCCR ).setFCR( this ); 


_ccrSet.add( newCCR ); 


public FCRSchema getFCRSchema () 
{ 


return _fcrSchema; 


/** Public access required by Castor Unmarshaller. */ 
public void setFCRSchema( FCRSchema v ) 


{ 


_fcrSchema = v; 


[** KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KK KKK KKK KK KKK 


* Gets the semantics for this FCR. 
* 


* @author Steve Shedd 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKK */ 
public FCRSemantics getFCRSemantics () 
{ 


return _fcrSemantics; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KK KKK KKK KKK 


* Sets the semantics for this FCR. 
* 


* @author Steve Shedd 


KKK KKK KKK KKK KKK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK */ 


public void setFCRSemantics( FCRSemantics sem ) 
{ 


_fcrSemantics = sem; 
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/[** KKKK KKK KKK KKK KK KKK KK KK KKK KK KK KK KKK KKK KK KK KK KK KK KK KK KK 


* Gets the syntax for this FCR. 
* 


* @author Steve Shedd 


KKK KKK KKK KKK KKK KK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKK KKKKKKEKEK */ 
public FCRSyntax getFCRSyntax () 


return _fcrSyntax; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK 


* Sets the syntax for this FCR. 
* 


* @author Steve Shedd 


KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK */ 


public void setFCRSyntax( FCRSyntax syn ) 
{ 


_fcrSyntax = syn; 


public String getJavaClassName () 
{ 


return _javaClassName; 


public void setJavaClassName( String className ) 
{ 


_javaClassName = className; 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK 


* A factory method that returns an instance of SearchHandler for search of 
* CCRs by system name of the CCRs. 
KEKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKKKKKKKKK */ 
public static SearchHandler makeCCRSystemNameSearchHandler ( 
String systemName, 
java.util.Set resultSet ) 
{ 


return new CCRSystemNameSearchHandler( systemName, resultSet ); 


[** KKK KKK KK KK KK KKK KK KK KK KKK KK KK KK KK KK KK KKK KK KK KK KKK KK KK KK KK KKK KKK KK KK KK KK KK KKK KKK 
* @param systemName 

* @param xmlNamespaceURI 

* @param result A single element array to hold the result, the element holds 


= a null value if no match found. 
KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KEKEKEK */ 


public static CCRKeySearchHandler makeCCRKeySearchHandler ( 
String systemName, URL xmlNamespaceURI, 
CCR[] result ) 


{ 
if ( result.length < 1 ) 


throw new IllegalArgumentException( "Argument result must not be an empty 
array.” )3 





return new CCRKeySearchHandler( systemName, xmlNamespaceURI, result ); 


static void pl( String m ) 
{ 


System.out.println( m ); 
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ce Class FCRSemanticsImpl 


J [BRK RR KKK KK KI KKK AAA A A IAA AAA Ae AAA AA A ee IAA A A A He He He oe 


// Filename:...........4. FCRSemanticsImpl.java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Oviginal Compiler:....Sun JDK 1.3.1_04 

Tf, BUCHO Bee ae tie Sesceiese: & LT Steve Shedd, USN 

// Company:........e2000% Naval Postgraduate School, Monterey, California 

Lf DAG ee see eis VE Wade aes September 2002 


J [BRR KK KKK KK KA A I I KKK AAA A ee IAA AA A Ae ee AAA AAA ee IAA A A A He He oe oe 


package mil.navy.nps.cs.oomi.impl; 
import mil.navy.nps.cs.oomi.fiom.FCRSemantics; 
public class FCRSemanticsImpl extends SemanticsImpl implements FCRSemantics 
{ 
public FCRSemanticsImpl () 


{ 


super (); 


8. Class FCRSyntaxImpl 


J [BRK KKK KK KK RA A I KKK AA A Ae ee AAA A A Ae ee AAA A Ae ee IA A A A A He He oe oe 


// Filename:............. FCRSyntaxImpl. java 

// Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

Lif BOCHORS ieee Vee oie ee LT Steve Shedd, USN 

// ‘Company 24 .4.44<4.004404 Naval Postgraduate School, Monterey, California 

] pRDAC Se oe ice Scere G.nuseek Ge usce September 2002 


J [RRR RK KK KK RA A KAA AAA ee AAA AA A ke ke AAA AA A ee IIA AA A A ee He oe 


package mil.navy.nps.cs.oomi.impl; 


import mil.navy.nps.cs.oomi.fiom.FCRSyntax; 
import mwa.ai.neural.Neural; 
import mwa.ai.neural.NNfile; 


public class FCRSyntaxImpl extends SyntaxImpl implements FCRSyntax 
{ 


private Neural _neuralNet = null; 


private String _nnFilePath = null; 


public FCRSyntaxImpl () 
{ 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKK KKK KKK 


* Get neural network for this FCR. 
* 


* @author Steve Shedd 


KKKKK KKK KK KK KKK KKK KKK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KK */ 
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public Neural getNeuralNetwork () 
{ 


return _neuralNet; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Set neural network for this FCR. 
* 


* @author Steve Shedd 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKKKKKKEKEK */ 
public void setNeuralNetwork( Neural netIn ) 


{ 


_neuralNet = netIn; 


[** KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKKKKKKKKKKKKKKKKKKKKK KKK KK KK KKK 


* Get the path to the neural network file for this FCR. 
* 


* @author Steve Shedd 


public String getNNfilePath () 
{ 


KKKK KKK KKK KK KK KKK KK KK KK KK KK KK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK */ 


return _nnFilePath; 


[** KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK KKK KKK KKK 


* Set the path for the neural network file for this FCR. 
* 


* @author Steve Shedd 


KKKKK KKK KKK KKK KK KKK KK KK KK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK */ 


public void setNNfilePath( String absolutePath ) 
{ 


_nnFilePath = absolutePath; 
} 
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A. 


APPENDIX C. NEURAL NETWORK SOURCE 


CLASS mwa.ai.neural.Neural 


J [BRR KKK KK KK KA I KKK AAA A ee IAA AAA A ee AAA A Ae ee IA A A A A He He oe oe 


// 
// 
// 
// 
// 
// 
// 
// 
// 
Yop 
// 
// 
// 
// 
// 
// 
// 
// 


Filename:............. Neural.java 
Parent Project:....... SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
Master of Computer Science Thesis Project 
Original Compiler:....Sun JDK 1.3.1_04 
RGOENOE he eee eiak 2s a 44 Mark Watson, in "Intelligent Java Applications" 
Date Created:......... 8/5/1996 
Modified by:.......... LT Steve Shedd, USN 
COMPADYE! si..<0 ee ee ee ee Naval Postgraduate School, Monterey, California 
DAC Sie ones eed andy tne: ane: gnty ener eye September 2002 
INOUE soi cs scscsdecscacacs sca cet nese > File modified for three reasons: 
(1) To confrom to JDK 1.3.1 and deprecated methods 
(2) To improve readability (improved commenting and layout) 
(3) Needs of thesis work 
Specific comments are provided where important code has been changed from 
the original. Deletions of minor code snippets, like System.out.printin 


calls, are not commented. 


J [BRR KR KKK KK RA A KAA AA A ee AAA AA Ae ke AAA A A ke ee IA A A A A He He He oe 


package mwa.ai.neural; 


import java.awt.*; 

import java.applet.Applet; 
import java.lang.*; 
import java.util.*; 


//import mwa.gui.GUI; 
//import mwa.data.*; 


public class Neural extends Object 


{ 


// For debug output: 
//GUI MyGUI = null; 


//Next line added by Steve Shedd 
public float learningRate; 


public int NumInputs; 
public int NumHidden; 
public int NumOutputs; 
public int NumTraining; 
protected int WeightsFlag; 
protected int SpecialFlag; 
public float Inputs[]; 


//Next four lines added by Steve Shedd 
public float HiddenLayer_In[]; 


public float HiddenLayer_Out[]; 





public float OutputLayer_In[]; 
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public float OutputLayer_Out[]; 


//public float Hidden[]; 
//public float Outputs[]; 


public float W1[] []; 

public float W2[] []; 

public float hidden_bias = 1.0f; 
public float output_bias = 1.0f; 
public float output_errors[]; 
public float hidden_errors[]; 


//Next two lines added by Steve Shedd 
public float diff[]; 


public float avgNetError; 


public float InputTraining[]; 





public float OutputTraining[]; 





// mask of training examples to ignore (true 
public boolean IgnoreTraining[] = null; 


// mask of Input neurons to ignore: 
public boolean IgnoreInput[] = null; 


public NNfile NeuralFile = null; 
public Neural () 


{ 
NumInputs = NumHidden = NumOutputs = 0; 


} 


public Neural( String file_name ) 


{ 


NeuralFile = new NNfile( file_name ); 
NumInputs = NeuralFile.NumInput; 
NumHidden = NeuralFile.NumHidden; 
NumOutputs = NeuralFile.NumOutput; 
NumTraining = NeuralFile.NumTraining; 
WeightsFlag = NeuralFile.WeightFlag; 
SpecialFlag = NeuralFile.SpecialFlag; 





//Next line added by Steve Shedd 
learningRate = .25f; 


Inputs = new float [NumInputs]; 


//Next four lines added by Steve Shedd 
HiddenLayer_In = new float [NumHidden]; 
HiddenLayer_Out = new float [NumHidden]; 
OutputLayer_In = new float [NumOutputs]; 
OutputLayer_Out = new float [NumOutputs]; 





//Hidden = new float [NumHidden]; 
//Outputs = new float [NumOutputs]; 

Wl = new float[NumInputs] [NumHidden]; 
W2 = new float [NumHidden] [NumOutputs]; 








avgNetError = 0; 
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-> 


ignore): 


// Retrieve the weight values from the NNfile object: 
if ( WeightsFlag != 0 ) 
{ 
for ( int i = 0; i < NumInputs; i++ ) 
{ 
for ( int h = 0; h < NumHidden; h++ ) 


W1[i] [h] = NeuralFile.GetWl1( i, h ); 


for ( int h = 0; h < NumHidden; h++ ) 
{ 


for ( int o = 0; o < NumOutputs; ot++ ) 





W2[h] [o] = NeuralFile.GetW2(h, o ); 


} 
else 
{ 
randomizeWeights (); 


} 


//Next line added by Steve Shedd 
diff = new float [NumOutputs]; 


output_errors = new float [NumOutputs]; 
hidden_errors = new float [NumHidden]; 


// Get the training cases (if any) from the training file: 
LoadTrainingCases (); 


public Neural( int i, int h, into ) 

{ 
System.out.println( "In BackProp constructor" ); 
Inputs = new float[i]; 


//Hidden = new float[h 
//Outputs = new float [ 
W1 = new float[i] [hl]; 
W2 = new float[h] [ol]; 
NumInputs = i; 
NumHidden = h; 
NumOutputs = o; 
output_errors = new float [NumOutputs]; 
hidden_errors = new float [NumHidden] ; 


ale 
ol; 


//Next four lines added by Steve Shedd 
HiddenLayer_In = new float [NumHidden]; 
HiddenLayer_Out = new float [NumHidden]; 
OutputLayer_In = new float [NumOutputs]; 
OutputLayer_Out = new float [NumOutputs]; 





//Next line added by Steve Shedd 
learningRate = .25f; 





//Next line added by Steve Shedd 
diff = new float [NumOutputs]; 


// Randomize weights here: 
randomizeWeights (); 
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public void LoadTrainingCases () 


{ 


NumTraining = NeuralFile.NumTraining; 
int ic = 0, oc = 0; 
if ( NumTraining > 0 ) 
{ 
InputTraining = new float[NumTraining * NumInputs]; 
OutputTraining = new float[NumTraining * NumOutputs]; 
} 
for ( int k = 0; k < NumTraining; k++ ) 
{ 
for ( int i = 0; i < NumInputs; i++ ) 
{ 
InputTraining[ict+] = NeuralFile.GetInput( k, i ); 





for ( int o = 0; 


OutputTraining[oct+] = 


o < NumOutputs; 


ott ) 


NeuralFile.GetOutput ( k, 


public void Save( String output_file ) 


Oo); 


{ 


new NNfile(); 

this.NumHidden; 
this.NumInputs; 
this.NumOutputs; 
this.NumTraining; 


NeuralFile = 
NeuralFile.NumHidden = 
NeuralFile.NumInput = 
NeuralFile.NumOutput = 
NeuralFile.NumTraining = 
NeuralFile.NumLayers = 3; 
NeuralFile.NumNeuronsPerLayer = 
NeuralFile.NumNeuronsPerLayer [0] 
NeuralFile.NumNeuronsPerLayer[1] = 
NeuralFile.NumNeuronsPerLayer[2] = 
NeuralFile.SpecialFlag = 0; 
//NeuralFile.BaseIndex 
//NeuralFile.TopIndex 
//NeuralFile.WeightFlag 


new int[3]; 

= NeuralFile.NumInput; 
NeuralFile.NumHidden; 
NeuralFile.NumOutput; 








NeuralFile.Save( output_file, InputTraining, OutputTraining, Wl, W2 ); 


public void randomizeWeights () 


{ 


double x = 
float scale_factor = 


Math.pow( NumHidden, ( 1 / NumInputs ) ); 
O.7£ * ( float )x; 


// Randomize weights here: 


for ( int ii = 0; ii < NumInputs; iit+ ) 





for ( int hh = 0; hh < NumHidden; hh++ ) 


{ 
//Changed by Steve Shedd 
W1[ii] [hh] = ( float )Math.random() - 0.5f; 
W1[ii] [hh] = ( scale_factor * W1[ii] [hh] ) 


/ Math.abs( W1[ii] [hh] 


int hh = 0; hh < NumHidden; hh++ ) 
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3 


for ( int oo = 0; oo < NumOutputs; oott+ ) 
{ 
//Changed by Steve Shedd 
W2[hh] [oo] = ( float )Math.random() - 0.5f; 


public void ForwardPass() 


{ 
TH thy Ay OF 


for (h = 0; h < NumHidden; h++ ) 

{ 
//Modified by Steve Shedd - change Hidden[h] to HiddenLayer_In[h] 
HiddenLayer_In[h] = hidden_bias; 

} 


for ( i = 0; i < NumInputs; i++ ) 
{ 
for (h = 0; h < NumHidden; h++ ) 
{ 
//Modified by Steve Shedd - change Hidden[h] to HiddenLayer_In[h] 
HiddenLayer_In[h] += Inputs[i] * Wl[i] [h]; 


} 
//Added by Steve Shedd - perform the activiation function for each input on 


//the hidden layer nodes. 
for (h = 0; h < NumHidden; ht++ ) 





HiddenLayer_Out [h] = Sigmoid( HiddenLayer_In[h] ); 
for (0 = 0; o < NumOutputs; o++ ) 
//Modified by Steve Shedd - change Outputs[o] to OutputLayer_In[o] 


OutputLayer_In[o] = output_bias; 


for (h = 0; h < NumHidden; h++ ) 





for (0 = 0; o < NumOutputs; ot++ ) 

{ 
//Modified by Steve Shedd - change Outputs[o] to OutputLayer_In[o] 
OutputLayer_In[o] += HiddenLayer_Out[h] * W2[h] [o]; 


for ( o = 0; o < NumOutputs; o++ ) 


//Modified by Steve Shedd - change Outputs[o] to OutputLayer_Out [o] 
OutputLayer_Out[o] = Sigmoid( OutputLayer_In[o] ); 





public float Train( float Ir ) 
{ 


return Train( InputTraining, OutputTraining, NumTraining, lr ); 


public float Train( float ins[], float outs[], int num_cases, float Ilr ) 


215 


//copy the ins and outs arrays to the InputTraining and Output 
//Trainig arrays. 


nputTraining = new float[ this.NumInputs * num_cases ]; 
OutputTraining = new float[ this.NumOutputs * num_cases ]; 


for ( int i= 0; i < ins.length; i++ ) 


InputTraining[i] = ins[il]; 


for ( int j = 0; j < outs.length; j++ ) 


OutputTraining[j] = outs[j]; 





Late; <3, 5: gros 
int in_count = 0, out_count = 0; 
float inst_error[] = new float [num_cases]; 


avgNetError = 0; 
if (lr !=0 
{ 


learningRate = lr; 


} 


for ( int example = 0; example < num_cases; examplet+ ) 


{ 


//Set instantaneous error for this training pattern to zero. 


inst_error[example] = 0.0f; 
if ( IgnoreTraining != null ) 
{ 
if ( IgnoreTraining[example] ) 


{ 


continue; // skip this case 
} 
} 


// zero out error arrays: 
for (h = 0; h < NumHidden; h++ ) 


{ hidden_errors[h] = 0.0f; } 
for (0 = 0; o < NumOutputs; ot++ ) 
{ output_errors[o] = 0.0f; } 


// copy the input values: 
for ( i = 0; i < NumInputs; i++ ) 


{ 


Inputs[i] = ins[in_count++]; 
} 
/* 
if (IgnoreInput != null) { 
for (int ii = 0; ii < NumInputs; iit+) { 
if (IgnoreInput[ii]) { 
for (int hh = 0; hh < NumHidden; hh++) { 
W1[ii] [hh] = 0; 
} 
} 
} 
} 
a 


// perform a forward pass through the network: 
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ForwardPass(); 
//if (MyGUI != null) MyGUI.repaint(); 


//for loop below implements the delta rule for determining error in the 
//output nodes. 
for (0 = 0; o < NumOutputs; ot++ ) 


{ 


//Next line added by Steve Shedd - Calculate difference between desired 
//output and actual output of the output layer node. 

//change Outputs[o] to OutputLayer_Out [o] 

diff[o] = outs[out_count++] - OutputLayer_Out [ol]; 


//Error information term 
output_errors[o] = diff[o] * SigmoidP( OutputLayer_In[o] ); 


} 


//Assigning error to each hidden layer node 
for (h = 0; h < NumHidden; h++ ) 
{ 

for (0 = 0; o < NumOutputs; o++ ) 


{ 


//Sum of delta inputs from output layer 
hidden_errors[h] += output_errors[o] * W2[h] [ol]; 


} 


//For loop below implements the delta rule for determining error in the 
//nidden layers. 

for (h = 0; h < NumHidden; h++ ) 

{ 


//Modified by Steve Shedd - changed Hidden[h] parameter of 
//SigmoidP function to HiddenLayer_In[h]. 


//Error Information Term for the hidden layer 
hidden_errors[h] = hidden_errors[h] * SigmoidP( HiddenLayer_In[h] ); 


} 


// update the hidden to output weights: 
for (0 = 0; o < NumOutputs; ot++ ) 
{ 

for (h = 0; h < NumHidden; ht+ ) 

{ 


//Modified by Steve Shedd - Original equations looked like this: 
// 

//W2[h][o] += learningRate * output_errors[o] * Hidden [h] 

// 

//However, Hidden array is populated in ForwardPass function and 
//represents the pre-Activation function input to the hidden node, 
//not the output. In the function below, the delta rule calls for 
//the hidden nodes output. So, the new array 

//HiddenLayer_Out[] is used. 


W2[h] [0] += learningRate * output_errors[o] * HiddenLayer_Out [h]; 


} 
// update the input to hidden weights: 


for (h = 0; h < NumHidden; h++ ) 
{ 
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for ( i = 0; i < NumInputs; i++ ) 


//Modified by Steve Shedd - Original equations looked like this: 
// 

//W2[h][o] += learningRate * hidden_errors[h] * Inputs[i] 

// 

//However, Inputs array holds the pre-summed and pre-weighted 
//inputs to the hidden node. In otherwords, the Inputs array holds 
//the raw input pattern. In the function below, the delta rule 
//calls for the actual input to the hidden layer node.This input 
//is produced in the ForwardPass function and stored in the 
//array Hidden[]. 


W1[i] [h] += learningRate * hidden_errors[h] * Inputs[i]; 


for (oo = 0; o < NumOutputs; ot++ ) 


//Modified by Steve Shedd - Original equations looked like this: 


ieee += Math.abs (output_errors[o]); 

Ueigeee equation should be the sum of the squares of the node errors. 
inst_error[example] += ( float )Math.pow( ( double )diff[o], 2 ); 
//Instantaneous error = error/2 

//inst_error[example] = inst_error[example] /2; 


} 


//returns average network error over entire training set 
for ( int j = 0; j < num_cases; j++ ) 
{ 


avgNetError += inst_error[j]; 


} 


return avgNetError; // num_cases; 


[** KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KK KKK 


* The Sigmoid Method below is also known as the logistic function or 


* transform function 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KEK */ 


// In both Sigmoid and SigmoidP methods below, I've removed the original 
// 0.5£ shift factor which defined the range from -0.5f to 0.5f. 

// The new range is 0.0f to 1.0f. 

protected float Sigmoid( float x ) 

{ 


return ( float )( (1.0f / ( 1.0f + Math.exp( ( double )( -x ) ) ) ) );//-0.5f; 


[** KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKK KKK KKK KKK KK KK 


* The SigmoidP function is simply the derivative of the Sigmoid function, or 


* logistic function. 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKKKK */ 


protected float SigmoidP( float x ) 
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double z = Sigmoid( x ); // + 0.5f; 
return i(-float:jiaag 4 C LOL Ze). Py 





B. Class mwa.ai.neural.NNfile 

J [BRR KR KKK KK KK KK KH KKK AA A ee KAA AA AA A A A IIA AAA AA A A ee He He oe 
// Filename:............- NNFile.java 

// Parent PLOFSCES ase ece SEMANTIC AND SYNTACTIC OBJECT CORRELATION IN THE OOMI IDE, 
// Master of Computer Science Thesis Project 

// Original Compiler:....Sun JDK 1.3.1_04 

[if AUENOLE 6h aie Ca eee es Mark Watson, in "Intelligent Java Applications" 

// Date Created:......... 8/5/1996 

// Modified by:.......... LT Steve Shedd, USN 

[if “COMPANY 5 5504 ark exes are eee Naval Postgraduate School, Monterey, California 

[sf DAE Csi ie ty one scwectee eo ese September 2002 

ff NOC OS 2525s bs cas lae aoeeele ee File modified for three reasons: 

ff 

// (1) To confrom to JDK 1.3.1 and deprecated methods 

// (2) To improve readability (improved commenting and layout) 

if (3) Needs of thesis work 

// 

// Specific comments are provided where important code has been changed from 

// the original. Deletions of minor code snippets, like System.out.printin 

// calls, are not commented. 


J [RRR RK RR KK KK KK KKK I A KKK AK A Ae RRA A Ae KAR A AAA A A A A Ae ee ee He He ee 9 Oe 


package mwa.ai.neural; 


import java.io.*; 
import java.net.URL; 
import java.util.*; 


//import java.lang.*; 


class FileFormatException extends Exception 


public Filer 
{ 


ormatException( String str ) 





super( str ); 


} 


public class NNfile 


{ 


public int NumLayers; 

public int NumNeuronsPerLayer[]; 

public int NumInput, NumHidden, NumOutput, NumTraining; 
public int WeightFlag; 


public int SpecialFlag; 





public int BaseIndex, TopIndex; 


private float data[]; 








public File inputFile = null; 
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public NNfile() 
{ 


NumLayers = NumInput = NumHidden = NumOutput = 0; 


public NNfile( String input_file ) 
{ 


data = new float[40000]; 

TopIndex = 0; 

FileInputStream is = null; 

try 

is = new FileInputStream( input_file ); 
inputFile = new File( input_file ); 


catch ( Exception E ) 


System.out.printin( "can not open file " + input_file ); 





if (is != null ) 


ReadFile( is ); 
is.close(); 
} 
} 
catch ( Exception E ) 
{ 
System.out.printin( "can not process file" ); 


} 


System.out.println( "Done with ReadFile, calling ParseData..." ); 
ParseData(); 

OutputStream f = null; 

System.out.println( "Done with ParseData(), write output..." ); 


void ParseData() 

{ 
int k = 0; 
NumLayers = ( int )data[k++]; 
NumNeuronsPerLayer = new int [NumLayers]; 


for ( int i = 0; i < NumLayers; i++ ) 


{ 


NumNeuronsPerLayer[i] = ( int )data[k++]; 
} 
NumInput = NumNeuronsPerLayer [0]; 
NumHidden = NumNeuronsPerLayer[1]; 
NumOut put = NumNeuronsPerLayer [2]; 
WeightFlag = ( int )data[kt++]; 





if ( WeightFlag == ) 
{ 


// Make room in data array for any weights added in later: 
int NumW = NumInput * NumHidden + NumHidden * NumOutput; 
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for ( int i = TopIndex; i > 6; i-- ) 
{ 
data[i + NumW] = datal[il; 
} 
TopIndex += NumW; 
} 


SpecialFlag = ( int )data[k++]; 
NumTraining = ( int )data[k++]; 
BaseIndex = k; 





// To get weights: 
public float GetW1( int input, int hidden ) 


{ 
if ( WeightFlag == ) 
{ 
return 0.0f; 


} 


return data[BaseIndex + 
+ input * NumHidden + hidden]; 


public float GetW2( int hidden, int output ) 


if ( WeightFlag == ) 
return 0.0f; 
return data[BaseIndex + 


+ NumInput * NumHidden + 
hidden * NumOutput + output]; 





// To set weights: 
public void SetW1( int input, int hidden, float x ) 


{ 


WeightFlag = 1; // set this so save() will save weights 
data[BaseIndex + 
+ input * NumHidden + hidden] = x; 


public void SetW2( int hidden, int output, float x ) 
{ 


WeightFlag = 1; // set this so save() will save weights 


data[BaseIndex + 
NumInput * NumHidden + 
+ hidden * NumOutput + output] = x; 


// To get any application specific data: 
public float GetSpecial( int i ) 
{ 


if ( SpecialFlag == ) 
{ 


return 0.0f; 


} 
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return data[BaseIndex + 
NumInput * NumHidden + NumHidden * NumOutput + i]; 


// To add application specific data: 
public void AddSpecial( float x ) 
{ 


// Make room in data array for a new special data value: 
int index = BaseIndex+NumInput *NumHiddent+tNumHidden*NumOutput+SpecialFlag; 


for ( int i = TopIndex - 1; i >= index; i-- ) 
{ 
data[i + 1] = data[i]; 
} 
TopIndext+; 
data[index] = x; 
SpecialFlagt+; 


// To get training cases: 
public float GetInput( int training_case, int neuron_index ) 


{ 


return data[BaseIndex + 

NumInput * NumHidden + NumHidden * NumOutput + 
SpecialFlag + 

training_case * ( NumInput + NumOutput ) + 
neuron_index]; 


public float GetOutput( int training_case, int neuron_index ) 


{ 


return data[BaseIndex + 

NumInput * NumHidden + NumHidden * NumOutput + 
SpecialFlag + 

training_case * ( NumInput + NumOutput ) + 
NumInput + 

neuron_index]; 


public void RemoveTraining( int num ) 


{ 


if ( num < 0 || num >= NumTraining ) 

{ 
System.out.printin( "Error in RemoveTraining(" + num + ")" ); 
return; 


} 


int index = BaseIndex + 

NumInput * NumHidden + NumHidden * NumOutput + 
SpecialFlag + 

num * ( NumInput + NumOutput ); 


for ( int i = index; i <= TopIndex —- NumInput - NumOutput; it+ ) 
{ 

data[i] = data[i + NumInput + NumOutput]; 
} 


TopIndex -= NumInput + NumOutput; 
NumTraining—-; 
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public void AddTraining( float inputs[], 


{ 


for int i = 0; ++ 


{ 


( i < NumInput; 


) 


data [TopIndex++] inputs[i]; 


( int o 0; o < NumOutput; ot++ 


) 


data [TopIndex++] outputs [o]; 


} 


NumTraining++; 


void ReadFile( InputStream inp ) 
{ 


throws 


System.out.println ( 


Reader r 
StreamTokenizer st 
st.commentChar( '#' ); 

st.eolIsSignificant( false ); 
st.parseNumbers (); 
System.out.printin ( 


"Before while" ); 
process: 
while ( 
{ 


true 


) 


switch 


{ 


( st.nextToken () 


) 


case StreamTokenizer.TT_EOL: 


"Entered ReadFile" 


new BufferedReader ( new InputStreamReader( inp ) 
new StreamTokenizer ( 


float outputs[] ) 


IOException, FileFormatException 


i 


3 
iy 


; 


System.out.println( "EOF found" ); 


break process; 

case StreamTokenizer.TT_NUMBER: 
float x = ( float )st.nval; 
data[TopIndex++] = x; 
break; 

default: 


System.out.printin( "Token 
break process; 








} 





System.out.println( "Done with while 


inp.close(); 


if ( st.ttype 
{ throw new FileFormatException( st.t 


public void Save( String save_file_name, 
{ 

try 

{ 


FileOutputStream f 
PrintStream ps 


new PrintStream ( 


(default) :" 


+ st.sval 


loop" ); 


!'= StreamTokenizer.TT_EOF ) 


oString () 


float wl[] [], float w2[] [] ) 


new FileOutputStream( save_file_name ); 


f ); 


ps.printin( "# Neural network data written by NNfile\n" ); 


ps.printlin( NumLayers + " 
for ( int i = 0; 


{ 


ps.println( NumNeuronsPerLayer [i] 


} 
ps.printin( "1 
ps.println( SpecialFlag + " 


i < NumLayers; 


# weight flag" 


# number of neuron layers" 
it+ ) 


i 


+ "  # neurons in layer "+ i ); 


i 
# special data flag" 
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// always write out weights 
di 


ps.println( NumTraining + " # number of training cases in file" ); 


ps.printin( "\n# Input layer to hidden layer weights:\n" ); 
for ( int i = 0; i < NumInput; i++ ) 
for ( int h = 0; h < NumHidden; h++ ) 
ps.print( wl[i] [h] +" "); 
eer RNAs; 
} 


ps.printin( "\n# Hidden layer to output layer weights:\n" ); 
for ( int h = 0; h < NumHidden; h++ ) 
for ( int o = 0; o < NumOutput; ott ) 
; ps.print( w2[h] [o] + "" ); 
eee mNn™ ) 5 
} 


if ( SpecialFlag > 0 ) 

ps.println( "\n# Special network data:\n" ); 
for ( int i = 0; i < SpecialFlag; i++ ) 
ps.println( GetSpecial( i) +" " ); 
ery UNS Sa bed 

} 


ps.printin( "\n# Training data:\n" ); 


for ( int i = 0; i < NumTraining; i++ ) 

{ for ( int j = 0; j < NumInput; j++ ) 
ps.print( GetInput( i, j ) +" " ); 
een us Lee Ie 
for ( int j = 0; j < NumOutput; jtt+ ) 
ps.print( GetOutput( i, j ) +" " ); 
De amine Wa sy» 

} 


System.out.println( "Done writing to output file." ); 
ps.close(); 
f.close(); 


catch ( Exception E ) 


System.out.println( "can not process the file " + save_file_name ); 


public void Save( String save_file_name, float ins[], float outs[], float wl[] [], 
float w2[] [] ) 

{ 
try 





FileOutputStream f = new FileOutputStream( save_file_name ); 
PrintStream ps = new PrintStream( f ); 

ps.println( "# Neural network data written by NNfile\n" ); 
ps.println( NumLayers + " # number of neuron layers" ); 
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for ( int i = 0; i < NumLayers; i++ ) 
{ 

ps.printin( NumNeuronsPerLayer[i] + "  # neurons in layer "+ i ); 
} 
ps.printin( "1 # weight flag" ); // always write out weights 
ps.println( SpecialFlag + " # special data flag" ); 
ps.printin( NumTraining + "  # number of training cases in file" ); 


ps.println( "\n# Input layer to hidden layer weights:\n" ); 
for ( int i = 0; i < NumInput; i++ ) 
for ( int h = 0; h < NumHidden; h++ ) 
ps.print( wl[{i] [h] +" "); 
ee hn) 
} 


ps.printin( "\n# Hidden layer to output layer weights:\n" ); 
for ( int h = 0; h < NumHidden; h++ ) 
for ( int o = 0; o < NumOutput; ott ) 
ps.print( w2[h] [o] +" " ); 
een, DY one rd 
} 


if ( SpecialFlag > 0 ) 

ps.println( "\n# Special network data:\n" ); 
for ( int i = 0; i < SpecialFlag; i++ ) 
ps.printin( GetSpecial( i) +" " ); 
eee NR) 

} 


ps.println( "\n# Training data:\n" ); 


int in_count = 0; 
int out_count = 0; 


for ( int i = 0; i < NumTraining; i++ ) 

for ( int j = 0; j < NumInput; j+t ) 
ps.print( ins[in_count++] +" " ); 
ees - sais 
for ( int j = 0; 3 < NumOutput; jtt ) 
ps.print( outs[out_countt++] +" " ); 
eee eulaa ber 

} 


System.out.println( "Done writing to output file." ); 
ps.close(); 
f.close(); 


} 
catch ( Exception E ) 


{ 


System.out.printin( "can not process the file " + save_file_name ); 


} 
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APPENDIX D. TEST XML SCHEMAS 


A. COMPONENT CLASS REPRESENTATION (CCR) XMLSCHEMAS 
1. Armored Fighting Vehicle 


<?xml version="1.0" encoding="UTF-8"?> 
<xsd:schema targetNamespace="http://nps.navy.mil/cs/oomi/systemD" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:systemD="http://nps.navy.mil/cs/oomi/systemD" elementFormDefault="qualified" 
attributeFormDefault="unqualified"> 
<xsd:element name="armoredFightingVehicle"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation> This sample schema provided for example 
in Figure II-1l. The armoredFightingVehicle of System D models the ground combat vehicle 
real-world entity.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="afvClassification" 
type="systemD: afvClassificationType"/> 
<xsd:element ref="systemD:afvLocation"/> 
<xsd:element ref="systemD:afvObsTime"/> 
<xsd:element name="afvStatus" type="systemD:afvStatusType" 
minOccurs="0"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="afvClassificationType"> 
<xsd:restriction base="xsd:string"> 
<xsd:minLength value="5"/> 
<xsd:maxLength value="14"/> 
<xsd:enumeration value="battleTank"/> 
<xsd:enumeration value="rocketLauncher"/> 
<xsd:enumeration value="truck"/> 
<xsd:enumeration value="unknown"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:element name="afvLocation"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="latitude" type="systemD: latitudeType"/> 
<xsd:element name="longitude" 
type="systemD: longitudeType"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:element name="afvObsTime"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation>The day of a month and timekeeping in 
hours and minutes of a calendar day, using the 24-hour clock system referenced to 
Greenwich Mean Time (GMT) .</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="day" type="systemD:dayType"/> 
<xsd:element name="hourTime" type="systemD:hourTimeType"/> 
<xsd:element name="minuteTime" 
type="systemD:minuteTimeType"/> 
<xsd:element name="stdTimeZone" 
type="systemD: stdTimeZoneType"/> 
</xsd:sequence> 
</xsd:complexType> 
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</xsd:element> 
<xsd:simpleType name="afvStatusType"> 
<xsd:restriction base="xsd:string"> 
<xsd:minLength value="7"/> 
<xsd:maxLength value="11"/> 
<xsd:enumeration value="operational"/> 
<xsd:enumeration value="damaged"/> 
<xsd:enumeration value="destroyed"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="dayType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-3] {1} [0-9] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="hourTimeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-2] {1} [0-9] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="minuteTimeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-5] {1} [0-9] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="stdTimeZoneType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:pattern value="[Z] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:complexType name="latitudeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="latDegMinSec" type="systemD: latDegMinSecType"/> 
<xsd:element name="nsHemisphere" type="systemD:nsHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:complexType name="longitudeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="longDegMinSec" 
type="systemD: longDegMinSecType"/> 
<xsd:element name="ewHemisphere" type="systemD :ewHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:simpleType name="latDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="6"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="longDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
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<xsd:length value="7"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="nsHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:enumeration value="N"/> 
<xsd:enumeration value="S"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="ewHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd: length value="1"/> 
<xsd:enumeration value="E"/> 
<xsd:enumeration value="W"/> 
</xsd:restriction> 
</xsd:simpleType> 
</xsd:schema> 


2. Mechanized Combat Vehicle 


<?xml version="1.0" encoding="UTF-8"?> 
<xsd:schema targetNamespace="http://nps.navy.mil/cs/oomi/systemB" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:systemB="http://nps.navy.mil/cs/oomi/systemB" elementFormDefault="qualified" 
attributeFormDefault="unqualified"> 
<xsd:element name="mechanizedCombatVehicle"> 
<xsd:annotation> 
<xsd:documentation> This sample schema provided for example in 
Figure II-l. The mechanizedCombatVehicle of System B models the ground combat vehicle 
real-world entity.</xsd:documentation> 
</xsd:annotation> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation>A mechanizedCombatVehicle msgtype 
provides System B model of ground combat vehicle real-world entity for the example in 
Figure III-3.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="mcvType" type="systemB:mcvType"/> 
<xsd:element ref="systemB:mcvLocation"/> 
<xsd:element ref="systemB:mcvTime"/> 
<xsd:element name="mcvRadius" 
type="systemB:distanceInkmType" minOccurs="0"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="mcvType"> 
<xsd:restriction base="xsd:string"> 
<xsd:minLength value="4"/> 
<xsd:maxLength value="16"/> 
<xsd:enumeration value="tank"/> 
<xsd:enumeration value="personnelCarrier"/> 
<xsd:enumeration value="reconVehicle"/> 
<xsd:enumeration value="unknown"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:element name="mcvLocation"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="utmZone" type="systemB:utmZoneType"/> 
<xsd:element name="mgrsEasting" 
type="systemB:mgrsEastingType"/> 
<xsd:element name="mgrsNorthing" 
type="systemB:mgrsNorthingType"/> 
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</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:element name="mcvTime"> 
<xsd:complexType> 
<xsd:annotation> 


<xsd:documentation>The day of a month and timekeeping in 


hours and minutes of a calendar day, 
time zone.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element 
<xsd:element 
<xsd:element 
type="systemB:minuteTimeType"/> 
<xsd:element 


using the 24-hour clock system and an associated 


name="day" type="systemB:dayType"/> 
name="hourTime" type="systemB:hourTimeType"/> 
name="minuteTime" 


name="localTimeZone" 


type="systemB: localTimeZoneType"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:complexType name="utmZoneType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="eastWest" type="systemB:eastWest ZoneType"/> 
<xsd:element name="northSouth" type="systemB:northSouthZoneType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:simpleType name="eastWestZoneType"> 
<xsd:restriction base="xsd:integer"> 
<xsd:minInclusive value="1"/> 
<xsd:maxInclusive value="60"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="northSout hZoneType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:pattern value="[A-V] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="mgrsEastingType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="4"/> 
<xsd:pattern value="[A-Z] {1} [0-9] {3}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="mgrsNorthingType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="4"/> 
<xsd:pattern value="[A-V] {1} [0-9] {3}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="dayType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-3] {1} [0-9] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="hourTimeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-2] {1} [0-9] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="minuteTimeType"> 
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<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-5] {1} [0-9] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="localTimeZoneType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:pattern value="[A-Z] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="distanceInKmType"> 
<xsd:restriction base="xsd:integer"> 
<xsd:minInclusive value="0"/> 
<xsd:maxInclusive value="1200"/> 
</xsd:restriction> 
</xsd:simpleType> 
</xsd:schema> 





B. FEDERATION CLASS REPRESENTATION (FCR) XML 
1. Ground Combat Vehicle View 1 


<?xml version="1.0" encoding="UTF-8"?> 
<xsd:schema target Namespace="http://nps.navy.mil/cs/oomi/fiomA" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:fiomA="http://nps.navy.mil/cs/oomi/fiomA" elementFormDefault="qualified" 
attributeFormDefault="unqualified"> 
<xsd:element name="groundCombatVehicleViewl"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation>This sample schema provided for example 
in Figure II-l. groundCombatVehicleViewl provides same perspective of ground combat 
vehicle real-world entity as System B mechanizedCombatVehicle model.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="vehicle" type="fiomA:vehicleType" 
minOccurs="0"/> 
<xsd:element ref="fiomA:position" minOccurs="0"/> 
<xsd:element ref="fiomA:time" minOccurs="0"/> 
<xsd:element name="range" type="fiomA:distanceInNmType" 
minOccurs="0"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="vehicleType"> 
<xsd:restriction base="xsd:string"> 
<xsd:minLength value="5"/> 
<xsd:maxLength value="16"/> 
<xsd:enumeration value="battleTank"/> 
<xsd:enumeration value="rocketLauncher"/> 
<xsd:enumeration value="truck"/> 
<xsd:enumeration value="personnelCarrier"/> 
<xsd:enumeration value="reconVehicle"/> 
<xsd:enumeration value="unknown"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:element name="position"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
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<xsd:sequence> 
<xsd:element name="latitude" type="fiomA: latitudeType"/> 
<xsd:element name="longitude" type="fiomA: longitudeType"/> 


</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:element name="time"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd: document 
hours and minutes of a calendar day, using 
time zone.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element 
<xsd:element 
type="fiomA: stdHourTimeType"/> 
<xsd:element 
type="fiomA:stdMinuteTimeType"/> 
<xsd:element 
type="fiomA: stdTimeZoneType"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 


ation>The day of a month and timekeeping in 
the 24-hour clock system and an associated 


=<" 


name= 


name= 


stdDay" type="fiomA:stdDayType"/> 
stdHourTime" 


name="stdMinuteTime" 


name="stdTimeZone" 


<xsd:simpleType name="distanceInNmType"> 
<xsd:restriction base="xsd:integer"> 
<xsd:minInclusive value="0"/> 
<xsd:maxInclusive value="1000"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="stdDayType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-3] {1} [0-9] {1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="stdHourTimeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 


<xsd:restriction base="xsd:s 
<xsd:length value="2" 
<xsd:pattern value=" 


tring"> 
/> 
0-2] {1} [0-9] {1}"/> 


</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="stdMinuteTimel 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="(0-5]{1}[0-9]{1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="stdTimeZoneType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:pattern value="(Z2]{1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:complexType name="latitudeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="latDegMinSec" type="fiomA: latDegMinSecType"/> 


2a2 


[ype"> 





<xsd:element name="nsHemisphere" type="fiomA:nsHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:complexType name="longitudeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="longDegMinSec" type="fiomA: longDegMinSecType"/> 
<xsd:element name="ewHemisphere" type="fiomA:ewHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:simpleType name="latDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="6"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="longDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="7"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="nsHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:enumeration value="N"/> 
<xsd:enumeration value="S"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="ewHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:enumeration value="E"/> 
<xsd:enumeration value="W"/> 
</xsd:restriction> 
</xsd:simpleType> 
</xsd:schema> 


2. Ground Combat Vehicle View 2 


<?xml version="1.0" encoding="UTF-8"?> 
<xsd:schema targetNamespace="http://nps.navy.mil/cs/oomi/fiomA" 
xmlns:fiomA="http://nps.navy.mil/cs/oomi/fiomA" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
attributeFormDefault="unqualified"> 
<xsd:element name="groundCombatVehicleView2"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation> This sample schema provided for example 
in Figure II-1l. groundCombatVehicleView2 provides same perspective of System C 
armoredMilitaryVehicle model of ground combat vehicle real-world entity for the example 
in Figure II-1.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="vehicle" type="fiomA:vehicleType" 
minOccurs="0"/> 
<xsd:element ref="fiomA:position" minOccurs="0"/> 
<xsd:element ref="fiomA:time" minOccurs="0"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="vehicleType"> 
<xsd:restriction base="xsd:string"> 
<xsd:minLength value="5"/> 
<xsd:maxLength value="16"/> 
<xsd:enumeration value="battleTank"/> 
<xsd:enumeration value="rocketLauncher"/> 
<xsd:enumeration value="truck"/> 
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hours and minutes of a calendar day, 


<xsd:enumeration value="personnelCarrier"/> 
<xsd:enumeration value="reconVehicle"/> 
<xsd:enumeration value="unknown"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:element name="position"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="latitude" type="fiomA: latitudeType"/> 
<xsd:element name="longitude" type="fiomA: longitudeType"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:element name="time"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation>The day of a month and timekeeping in 
using the 24-hour clock system and an associated 


time zone.</xsd:documentation> 


</xsd:annotation> 

<xsd:sequence> 
<xsd:element 
<xsd:element 


=<" 


name= 


name= 


stdDay" type="fiomA:stdDayType"/> 
stdHourTime" 


type="fiomA:stdHourTimeType"/> 
<xsd:element 
type="fiomA:stdMinuteTimeType"/> 
<xsd:element 
type="fiomA:stdTimeZoneType"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="stdDayType"> 


name="stdMinuteTime" 


name="stdTimeZone" 


<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 


<xsd:pattern value=" 
</xsd:restriction> 
</xsd:simpleType> 


[0-3] {1} [0-9] {1}"/> 


<xsd:simpleType name="stdHourTimeType"> 


<xsd:annotation> 
<xsd:documentation/> 

</xsd:annotation> 

<xsd:restriction base="xsd:s 


<xsd:length value="2" 


<xsd:pattern value=" 
</xsd:restriction> 
</xsd:simpleType> 


<xsd:simpleType name="stdMinuteTimel 


<xsd:annotation> 
<xsd:documentation/> 

</xsd:annotation> 

<xsd:restriction base="xsd:s 


tring"> 
/> 
0-2] {1} [0-9] {1}"/> 


rype"> 


tring"> 


<xsd:length value="2"/> 


<xsd:pattern value=" 
</xsd:restriction> 
</xsd:simpleType> 





0-5] {1} [0-9] {1}"/> 


<xsd:simpleType name="stdTimeZoneType"> 


<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 


<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:pattern value="[Z]{1}"/> 


</xsd:restriction> 
</xsd:simpleType> 


<xsd:complexType name="latitudeType"> 


<xsd:annotation> 
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<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="latDegMinSec" type="fiomA: latDegMinSecType"/> 
<xsd:element name="nsHemisphere" type="fiomA:nsHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:complexType name="longitudeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="longDegMinSec" type="fiomA: longDegMinSecType"/> 
<xsd:element name="ewHemisphere" type="fiomA:ewHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:simpleType name="latDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="6"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="longDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="7"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="nsHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:enumeration value="N"/> 
<xsd:enumeration value="S"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="ewHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:enumeration value="E"/> 
<xsd:enumeration value="W"/> 
</xsd:restriction> 
</xsd:simpleType> 
</xsd:schema> 


3. Ground Combat Vehicle View 3 


<?xml version="1.0" encoding="UTF-8"?> 
<xsd:schema targetNamespace="http://nps.navy.mil/cs/oomi/fiomA" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:fiomA="http://nps.navy.mil/cs/oomi/fiomA" elementFormDefault="qualified" 
attributeFormDefault="unqualified"> 
<xsd:element name="groundCombatVehicleView3"> 
<xsd:complexType> 
<xsd:annotation> 
<xsd:documentation> This sample schema provided for example 
in Figure II-l. groundCombatVehicleView3 provides same perspective of ground combat 
vehicle real-world entity as System D armoredFightingVehicle model.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="vehicle" type="fiomA:vehicleType" 
minOccurs="0"/> 
<xsd:element ref="fiomA:position"/> 
<xsd:element ref="fiomA:time"/> 
<xsd:element name="Status" type="fiomA:statusType" 
minOccurs="0"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="vehicleType"> 
<xsd:restriction base="xsd:string"> 
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<xsd:minLength value="5"/> 
<xsd:maxLength value="16"/> 


<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:element name="position"> 
<xsd:complexType> 
<xsd:annotation> 


value="battleTank"/> 
value="rocketLauncher"/> 
value="truck"/> 
value="personnelCarrier"/> 
value="reconVehicle"/> 
value="unknown"/> 


<xsd:documentation/> 


</xsd:annotation> 
<xsd:sequence> 


<xsd:element name="latitude" type="fiomA:latitudeType"/> 


<xsd:element 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:element name="time"> 
<xsd:complexType> 
<xsd:annotation> 


name="longitude" type="fiomA: longitudeType"/> 


<xsd:documentation>The day of a month and timekeeping in 


hours and minutes of a calendar day, 
time zone.</xsd:documentation> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element 
<xsd:element 
type="fiomA:stdHourTimeType"/> 
<xsd:element 
type="fiomA:stdMinuteTimeType"/> 
<xsd:element 
type="fiomA: stdTimeZoneType"/> 
</xsd:sequence> 
</xsd:complexType> 
</xsd:element> 
<xsd:simpleType name="stdDayType"> 


using the 24-hour clock system and an associated 


name="stdDay" type="fiomA:stdDayType"/> 
name="stdHourTime" 


name="stdMinuteTime" 


name="stdTimeZone" 


<xsd:restriction base="xsd:string"> 
<xsd: length value="2"/> 
<xsd:pattern value="[0-3] {1} [0-9] {1}"/> 


</xsd:restriction> 
</xsd:simpleType> 


<xsd:simpleType name="stdHourTimeType"> 


<xsd:annotation> 


<xsd:documentation/> 


</xsd:annotation> 


<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-2] {1} [0-9] {1}"/> 


</xsd:restriction> 
</xsd:simpleType> 


<xsd:simpleType name="stdMinuteTimeType"> 


<xsd:annotation> 


<xsd:documentation/> 


</xsd:annotation> 


<xsd:restriction base="xsd:string"> 
<xsd:length value="2"/> 
<xsd:pattern value="[0-5] {1} [0-9] {1}"/> 


</xsd:restriction> 
</xsd:simpleType> 


<xsd:simpleType name="stdTimeZoneType"> 


<xsd:annotation> 


<xsd:documentation/> 


</xsd:annotation> 


<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
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<xsd:pattern value="(Z2]{1}"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:complexType name="latitudeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="latDegMinSec" type="fiomA: latDegMinSecType"/> 
<xsd:element name="nsHemisphere" type="fiomA:nsHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:complexType name="longitudeType"> 
<xsd:annotation> 
<xsd:documentation/> 
</xsd:annotation> 
<xsd:sequence> 
<xsd:element name="longDegMinSec" type="fiomA: longDegMinSecType"/> 
<xsd:element name="ewHemisphere" type="fiomA:ewHemisphereType"/> 
</xsd:sequence> 
</xsd:complexType> 
<xsd:simpleType name="latDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="6"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="longDegMinSecType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="7"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="nsHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:enumeration value="N"/> 
<xsd:enumeration value="S"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="ewHemisphereType"> 
<xsd:restriction base="xsd:string"> 
<xsd:length value="1"/> 
<xsd:enumeration value="E"/> 
<xsd:enumeration value="W"/> 
</xsd:restriction> 
</xsd:simpleType> 
<xsd:simpleType name="statusType"> 
<xsd:restriction base="xsd:string"> 
<xsd:minLength value="7"/> 
<xsd:maxLength value="11"/> 
<xsd:length value="3"/> 
<xsd:enumeration value="operational"/> 
<xsd:enumeration value="damaged"/> 
<xsd:enumeration value="destroyed"/> 
</xsd:restriction> 
</xsd:simpleType> 
</xsd:schema> 
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